Not logged in
Log in now
Create an account
Subscribe to LWN
LWN.net Weekly Edition for May 23, 2013
An "enum" for Python 3
An unexpected perf feature
LWN.net Weekly Edition for May 16, 2013
A look at the PyPy 2.0 release
Linux technology reference:
Posted Sep 25, 2008 4:23 UTC (Thu) by constantine (guest, #53664)
User manuals for free software
Posted Sep 25, 2008 13:51 UTC (Thu) by sbergman27 (guest, #10767)
Good documentation is one of the hallmarks of a successful project. And in my experience, if the quality of the documentation is poor early on in the project, it stays that way, no matter how much lip-service gets paid to improving it on the mailing list. Users should not waste too much time waiting and hoping that a poorly documented product will get better. Making a clean break and finding something else usually saves *much* time and frustration in the long run.
Posted Sep 25, 2008 23:47 UTC (Thu) by giraffedata (subscriber, #1954)
as the devs, who felt that writing documentation was below their station, talked amongst themselves about how cool release x+1 was going to be.
I don't think they felt writing documentation was below their station; they felt it was boring. As they get paid the same to do boring writing as to design and code the cool new release, the choice is obvious.
Posted Oct 2, 2008 3:53 UTC (Thu) by dirtyepic (subscriber, #30178)
Copyright © 2013, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds