Wednesday, November 02, 2005

some questions

first,
my today's progress:
  • srs
    • use cases added
    • use case diagramm made
    • screenshot in the appendix replaced
  • domain model improved
explanations:
--------------------------

gui
on every page you have one edit button, with this you can edit all possible comments in this page.

problems:
--------------------------
  • i have some problem with the use case for the 'sharedcodedoc project setup'. because i thougt so far, that the projects are on the same machine as the application is running. with the solution, which the projects are on the same machine it shouldn't be difficult to describe the process of project setup. but with the other one, it's very difficult. because we have the source files on two machines and the machines have no relationship to each other. tracking the changes and merging the documentation are very difficult. do you have any good ideas? or is that a problem up to the implementation of the source control feature? and i can accept, that the projects are on the same server?
  • the solution, which we generate a base documentation sounds nice (thx to reto). but how often would you synch back the comments? how long should the period be? because you have then not at every time the newest source to document.
  • for the conflict resultion problem, i have no idea, how we can fix this problem. i think we should make a skype conference tomorrow evening (swiss time) and discuss this. i think this is a major problem, that we should solve, before we start the implementation.

1 Comments:

At 6:29 PM, Anonymous Anonymous said...

Pascal,

Domain-Model:
-------------
I like your domain model. Here some changes to make it complete:
- Add Enum and Struct below Namespace and add appropriate relations to the elements below.
- Make sure Interface doesn't include Constructor. Or am I missing something here?


SRS:
----
As Remy mentioned, I don't think real time sync is possible. It needs to be triggered manually or after a schedule plan (nightly, weekly or manual). Please adjust SRS with this. More details below.

To your questions:
-------------------
For the source code location, let's say each solution has a root path which could be a network share drive as well. Let's exclude source managment system here.

Synchronization should be a configurable schedule setting. E.g. Nightly, Weekly or Manual.

For conflict resolution let's have following admin options:
- Web docu as Master
- Source code as Master
- User resolves manually

Whenever the synchronization happens (e.g. Nightly) it will either overwrite based on the Master setting or compose a list of items to resolve. After synchronization the user/editor will see all his conflicts which he needs to decide on whether to use his change from the web docu or the one in the source code.

 

Post a Comment

<< Home