| This is a good idea, a great thing to push for. I feel immensely gratified. I already do this except for one thing. That one thing that I don't do is breaking down the docs into subsets. The reason I haven't is because the docs are small enough for me to not care. (3MB total download each for releases of both major repos, and that includes everything, including source, tests, and docs.) But otherwise, I do this. My docs are in a Markdown-like format (so you technically don't even have to build them), they contain everything you need to know, they are pre-built or need only FOSS tools to build (which I will actually replace with tools contained in the repo itself), they even include how to hack on my code: a braindump of design, implementation, and my mindset when I hack. That doesn't mean I can't make an online version. I can. However, people who download the repos can still use it offline. (Another thing I need to do is have a link from the online version to the source, probably in the footer.) I highly suggest everyone do this. It has delighted my users. |