Thread Links Date Links
Thread Prev Thread Next Thread Index Date Prev Date Next Date Index

Re: change tracking Re: Draft Standard Text, V02.1



Of course, committing revisions to the SVN repository
records changes.  However, these changes might not be so easy
for everyone to see unless they are documented.

Baker

On 3/29/2010 10:17, Christian Keil wrote:
John,

what a piece of work ,o).

First of all some procedural ideas regarding your comments---perhaps
they are obvious.

1) Change tracking
Since editing of the standard will ultimately probably be done by you
(or at least a technical editor) change tracking has to be somewhat
manual I think. Depending on your wishes several tools can offer some
support. Out of my head:
- For multiple authors OpenOffice and LyX, which is an Office-esque
frontend for LaTeX, offer change tracking with recording of the author.
- Depending on the size of your commits subversion commit comments
offer a possibility. This could be supported by setting up a trac
(http://trac.edgewall.org/) or redmine (http://www.redmine.org/), which
provide web access to the subversion repository (read only) with a
graphical diff and display of commit messages---besides that they
feature a wiki, milestones and the like, which could be of further
interest for our purpose for example for tracking motions.

2) Traceability
This seems easy for motions that directly contain standard text. The
mapping to the motion could be put in the standard draft like your
current change tracking. The other way round could be put into the
final, approved version of the motion on the website. Otherwise it
seems difficult and could probably be done via some tracking of motion
dependence?

I attach a marked up version of the document and a summary of the
comments.

Regards,
	
	Christian

On 2010-03-14 16:25, John Pryce wrote:
P1788

At last I have revised the draft Standard Text in the light of
comments received. I urge EVERYONE to read this Version 02,
sub-version 1, and give me comments, even if these are only that you
(a) like it or (b) hate it.

I think we are at a stage where parts, at least, of this document can
be voted on to become official text. I shall discuss with the
Officers in the next days on the best procedure to put this in hand.

The Latex of this version is Revision 22 on the P1788 subversion
server.

Best wishes

John Pryce



--

---------------------------------------------------------------
R. Baker Kearfott,    rbk@xxxxxxxxxxxxx   (337) 482-5346 (fax)
(337) 482-5270 (work)                     (337) 993-1827 (home)
URL: http://interval.louisiana.edu/kearfott.html
Department of Mathematics, University of Louisiana at Lafayette
(Room 217 Maxim D. Doucet Hall, 1403 Johnston Street)
Box 4-1010, Lafayette, LA 70504-1010, USA
---------------------------------------------------------------