Document creation and versioning

nzcarrick · 04-17-2009, 05:02 AM

Hello All,

I need to create some training documentation on a software program, it needs to be versioned. I am looking for GNU or other opensource licence. It also needs the possibility to copy off so two or more concurrent versions could be active.
What is everybody using?

cmdln · 04-17-2009, 06:15 AM

Quote:

Originally Posted by nzcarrick

Hello All,

I need to create some training documentation on a software program, it needs to be versioned. I am looking for GNU or other opensource licence. It also needs the possibility to copy off so two or more concurrent versions could be active.
What is everybody using?

I would reccomend sphinx doc combined with git. You write the documentation in restructured text then generate the HTML, PDF, or whatever.

Fit is great for versioning you can use branches to deal with multiple versions where the content is different. But if your talking about HTML and PDF versions you can just generate those.

nzcarrick · 04-17-2009, 08:19 AM

Cheers cmdln,
Do I need to know how to use git, and if I want versioning must i use git?

I would just be using PDF & HTML

Thanx in advance.

cmdln · 04-17-2009, 10:53 PM

Quote:

Originally Posted by nzcarrick

Cheers cmdln,
Do I need to know how to use git, and if I want versioning must i use git?

I would just be using PDF & HTML

Thanx in advance.

You don't have to use git there are other options like mercurial, cvs, svn, darcs, bazar. Any versioning system will work. I'd reccommend using a distributed version system like git instead of something like cvs or svn.