Quote:
Originally Posted by gweminence
Recognizing that the thread has slightly gone off track, I have to say that I agree wholeheartedly with Chaley. Companies that develop software nearly NEVER have the same people writing the code, and writing the documentation, In this case, open-source software, where it's just a few small developers...well. Your expectations for thorough and complete documentation should be kept under control. These guys simply do not have the resources to do it like most of us are used to seeing from commercial software.
But, that's sort of moot. Because I've had 3 issues since I've started using calibre. None of them critical. And all 3 times that I posted, chaley and griker immediately answered, helped, and even wrote out a bit of code. Call it 'interactive' documentation if you will, but I'll take that over a pdf file any day.
I think what bothers these guys most probably is the implied sense of entitlement. There IS no entitlement here, only the authors' good will.
|
Precisely. Well said!
Quote:
Originally Posted by Starson17
Aside from the advantage of more resources, commercial software tends to have long development periods with infrequent releases. It's a lot easier to keep documentation in synch when the software being documented is unchanging. Personally, I prefer Calibre's model where slightly incomplete documentation is balanced by rapid improvement and near instant live support.
|
Again, well said!
Quote:
Originally Posted by kovidgoyal
 That is, IMO, the coolest thing about calibre.
|
Yes, it is
Quote:
Originally Posted by kovidgoyal
I'll just say this, calibre is a community effort, if you feel some part of calibre is not as good as it should be, roll up your sleeves, and contribute.
I am always happy to accept the contributions of calibre's community, be they in the form of code, recipes, documentation, translations, *useful* bug reports.
|
Kovid has been very supportive of the community's wants and wishes, even if he doesn't see the need for whatever it is that is wanted/wished for. If I had the knowledge and a unique perspective, believe me, I'd be in there up to my elbows. As it is, however, my programming is non existent, and about the best thing I can offer is proofreading, LOL. If you want that, let me know.