View Single Post
Old 01-19-2011, 03:16 AM   #36
unboggling
Wizard
unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.unboggling ought to be getting tired of karma fortunes by now.
 
Posts: 1,065
Karma: 858115
Join Date: Jan 2011
Device: Kobo Clara, Kindle Paperwhite 10
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.
unboggling is offline   Reply With Quote