I vote for an SCM, which means it would be implemented with the code SCM whenever that happens. I'm not sure what you use to write your docs Brendan, but mine are done in LaTeX and DocBook making an SCM the prime way to go about it. I manage all my docs and the docs for Enlightenment this way. If you then want automation to a public locale, assuming you don't just link to a web viable SCM interface (CVS-Web or Subversion) you can dump the doc into the final location.
Just out of curiousity, whats wrong with the file upload section of the web interface we currently have? Your a docs community leader, so you have upload permissions. If your writting in HTML then perhaps it sucks to delete and re-up your doc (assuming you don't just edit it online via the web interface) but if your using PDF its the way to go anyway. benr. Brendan Gregg wrote: >G'Day Folks, > >In the past I've written docs for my site and docs for other sites. I >have a feeling for what works and what doesn't. To cut a long story short, > >Not having write access sux. Sometimes you want to make a series of quick >updates. Having write access to opensolaris.org may be difficult to setup >for everyone (eg, sourceforge style), perhaps a little easier if there was >an writable upload directory and a deamon to farm things out (eg, CPAN >style). But still not very easy. > >There is one easyish solution if you are the sole contributer. It goes >like this, > >1. contributer writes document, obeys OpenSolaris style checklist, uploads > to THEIR own website (perhaps a non-public URL). >2. contributer posts URL to docs-discuss, asks if document may be included > on opensolaris.org. >3. if so, URL is added to a script that downloads and caches the document > on opensolaris.org. This script is crontab'd to run every week, and > performs a few checks on content to avoid caching 404 errors, etc. >4. contributer freely updates the document on THEIR website, > opensolaris.org automatically picks up the changes every week. > >This means contributers can update opensolaris.org without needing write >access. They just make changes to their site. > >this doesn't help if a few people are working on the same document... > >Brendan > > >_______________________________________________ >docs-discuss mailing list >docs-discuss at opensolaris.org > >
