I'm willing to help with documentation. Yesterday when I mentioned that python scared me, GRiker recommended Mark Lutz's book. I noticed there were 3 and bought them all:
Learning Python, Programming Python, Python Pocket Reference. Regarding documentation of calibre, I think it would be useful to think of documentation as having several levels and separating them:
1. Beginner's Guide to calibre. Overview, not technical. The conceptual framework. So technical revisions would rarely need to be included/updated. Authors/contibutors, a group of anyone willing who is past beginner stage.
2. Power Users Guide to calibre, or Programming calibre. Authors/contributors, any willing power users, vetted but not written by developers.
3. Developer's Documentation. Whatever they think it should be since it's primarily for them, with perhaps a few power users looking at it once in awhile.
|