[Gnumed-devel] Re: GNUmed manual

[Gour]

>>>>> "Karsten" == Karsten Hilbert <address@hidden> writes:

Hello Karsten!

Karsten> I am reading emails on this very list. When I discover that
Karsten> something needs to be better documented I do so, perhaps write
Karsten> a new chapter in the Manual, update another one and reply with
Karsten> an URL to that.

We speak about different things: you talk about updating docs online, I speak
about having doc-team which works on documentation offline.

You can write during you night-shift in reST, save it and email to your
email.

If you would have e.g. bzr (only python is required) you could do 'bzr
send' to email the bundle ready for merging or even 'bzr push' to push
changes to your personal branch at LP.


So, it's not that all of you (doctors) cannot write or submit your
changes even on those limiting-machines available during night-shifts.

There are two points:

1) do you want to write in reST markup? 

2) do you want to change workflow and agree to out docs under VCS and
e.g using sphinx for automatic doc generation?


Karsten> Documentation is a bad example for what you are trying to
Karsten> say. Of course do I not commit every little code change to the
Karsten> server immediately but rather in chunks when things start
Karsten> getting ready.

Sure, but with DVCS I commit every little change because commit is done
locally, without 'disturbing' other devs.

All my writing is under DVCS.

Karsten> "Release early, release often" applies to committing just as
Karsten> much as to actual releases.

Committing with DVCS is cheap 'cause everyone works on his branch(es),
but releases should be done not 'often' but when ready, especially
considering that EMR is sensitive application.

Karsten> It probably won't be possible but I don't think that's a
Karsten> problem because the VCS thing is an either-or affair.

Heh, it's a problem if I use non-CVS VCS and commit there and you stay
with CVS :-)


Sincerely,
Gour


-- 

Gour  | Zagreb, Croatia  | GPG key: C6E7162D
----------------------------------------------------------------

pgpdlrXJFMw_7.pgp
Description: PGP signature