CVS, aka concurrent versioning system, is a way for us all to modify the same documents without getting totally confused.
You 'cvs checkout' a document. CVS records where it came from, where it's stored, and stuff like that automagically.
You then make changes, and 'cvs commit' the changes. CVS puts a copy of the document on the server, recording what the changes were and who made them.
Every time you come to the document again, 'cvs update'. This pulls everyone else's changes down, and gives you the current version of the document.
If there's a clash - if there winds up being two versions of the document - CVS intelligently merges them and signals where the duplicated bits are with funny characters. (% symbols, I think. But it's pretty obvious when you look through the document.) It expects a human to look through the document and figure out which lines to keep.
If two people have answered different questions that didn't have answers, just edit out the blank lines and re-commit (cvs commit) the document.
If two people have answered the /SAME/ question, edit out CVS' "what do I do here" marks, keep both answers in, 'cvs commit' it, and email me and I'll do my best to merge the two.
To use CVS:
* make sure you have cvs installed on your own machine. (locate cvs, perhaps?)
* create a directory for linuxchix stuff.
* follow the instructions on https://sourceforge.net/cvs/?group_id=4338
(or: go to http://www.sourceforge.net/, check your 'my projects' section and go to linuxchix-faqs, and from there go to 'cvs repository' which should be one of the icons on the top right and is also linked to in the body of the page.)
* if you need more help with CVS, ask me or ask here or ask on the linuxchix-faqs sourceforge lists.
Docbook:
Docbook is the markup language (like HTML) that we're using so we can have multiple versions of the same document. Docbook lets us run a simple command and it goes through and makes HTML, or postscript, or text, or whatever versions we want.
For the body of documents, docbook is easy to use. Just copy the stuff I've already got, and you should be fine.
Let me, or someone already conversant with docbook, make up the document headers. Or read ours, and figure it out.
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
The main techniques are CVS and docbook.
CVS, aka concurrent versioning system, is a way for us all to modify the same documents without getting totally confused.
You 'cvs checkout' a document. CVS records where it came from, where it's stored, and stuff like that automagically.
You then make changes, and 'cvs commit' the changes. CVS puts a copy of the document on the server, recording what the changes were and who made them.
Every time you come to the document again, 'cvs update'. This pulls everyone else's changes down, and gives you the current version of the document.
If there's a clash - if there winds up being two versions of the document - CVS intelligently merges them and signals where the duplicated bits are with funny characters. (% symbols, I think. But it's pretty obvious when you look through the document.) It expects a human to look through the document and figure out which lines to keep.
If two people have answered different questions that didn't have answers, just edit out the blank lines and re-commit (cvs commit) the document.
If two people have answered the /SAME/ question, edit out CVS' "what do I do here" marks, keep both answers in, 'cvs commit' it, and email me and I'll do my best to merge the two.
To use CVS:
* make sure you have cvs installed on your own machine. (locate cvs, perhaps?)
* create a directory for linuxchix stuff.
* follow the instructions on https://sourceforge.net/cvs/?group_id=4338
(or: go to http://www.sourceforge.net/, check your 'my projects' section and go to linuxchix-faqs, and from there go to 'cvs repository' which should be one of the icons on the top right and is also linked to in the body of the page.)
* if you need more help with CVS, ask me or ask here or ask on the linuxchix-faqs sourceforge lists.
Docbook:
Docbook is the markup language (like HTML) that we're using so we can have multiple versions of the same document. Docbook lets us run a simple command and it goes through and makes HTML, or postscript, or text, or whatever versions we want.
For the body of documents, docbook is easy to use. Just copy the stuff I've already got, and you should be fine.
Let me, or someone already conversant with docbook, make up the document headers. Or read ours, and figure it out.
http://sourceforge.net/projects/sfsetup/ is a Windows setup for sourceforge, with information about CVS and the like.
http://www.docbook.org/ is a useful Docbook page.