Re: Occasional words sticking out from flush-right

[Aditya Mahajan <adityam@umich.edu>]

On Thu, 4 Mar 2010, James Fisher wrote:

>> I'm not saying that a dcvs is useless for documentation or manuals.
>> But without contributors a dcvs can be practically useless,
>> and the only contributors for manuals actually are Taco for luatex and
>> Hans for Context mkiv.
>>
>>
> Why are they the only contributors?

Because no one else (myself included) has actually contributed anything to 
the documentation Compare

http://foundry.supelec.fr/gf/project/contextman/scmsvn/?action=ScmStats

vs the number of "developers"

http://foundry.supelec.fr/gf/project/contextman/

To be honest, other people have contributed, especially 
in translations of the documentations, and documenting some exotic 
features. But most beginner level and user documentation is written by 
Hans and Taco.

In my opinion, it is hard to write coherent documentation in a distrbuted 
manner (different writing styles, etc.). You are saying that it is just a 
matter of having the right infrastructure. Judging by the way things have 
evolved in the past, I am not so sure. If you really want to test how 
online documentation will work, you can try to convert parts of the 
beginners document to html. Compare

http://foundry.supelec.fr/gf/project/contextman/scmsvn/?action=browse&path=%2Fcontext-beginners%2Fen%2Fma-cb-en-itemizations.tex&view=markup

with what you are writing using sphinx.

Aditya
___________________________________________________________________________________
If your question is of interest to others as well, please add an entry to the Wiki!

maillist : ntg-context@ntg.nl / http://www.ntg.nl/mailman/listinfo/ntg-context
webpage  : http://www.pragma-ade.nl / http://tex.aanhet.net
archive  : http://foundry.supelec.fr/projects/contextrev/
wiki     : http://contextgarden.net
___________________________________________________________________________________