Downloadable Documentation is important
Posted on:June 26 2011
Dear developers, if you are creating a software library to be used by other programmers, then you need documentation. Without that, nobody will use your library. Simply because nobody will know how. And if you provide some documentation, putting it on your website won't be enough. It must be possible to download it somewhere.
I am currently integrating a C library into a project I am working on, and there is only the documentation available on the website. Contacting the developers, asking them to provide the docs as download somewhere resulted in the following answer: "We want you to use always the latest version of our documentation. So simply use the one on the website". Great, but that doesn't help me. I'm probably not going to update the C library in my software all the time. I need the documentation of the version of library I am using now. And, I'm not going to rely on your webserver. What if it goes down? What if you suddenly decide to stop the project and delete all content on your server? What if it gets hacked?
So, I just used a Website downloader, and grabbed the whole 200 MB of your entire website. Just to get the documentation of your library. (And interestingly, I also found some embarrassing private pictures of one of the developers by doing that, but that's another story.) I don't think other developers will go that path, they probably will simply use another library.
|Link ||[url] www.example.com [/url] |
|Bold ||[b]bold text[/b] |
|Quote ||[quote]quoted text[/quote] |
|Code ||[code]source code[/code] |