Why not publish documentation on readthedocs.org? It is a similar solution like github for code, but for documentation.
You can include your docs in your code repository written in Markdown or reStructuredText. Readthedocs will pull it and compile it for people to read and search online. On GitHub, you can even edit the docs online with it's online editor. Just browse the site and have a look at the kind of projects hosting their documentation there. Regards, Stefan Tunsch Sobre 10/02/2016 8:29:48, Stefano Zacchiroli <[email protected]> escribió: On Tue, Feb 09, 2016 at 08:27:38PM -0500, Martin Blais wrote: > I find the reaction from people in the OSS community interestingly > puzzling and somewhat curmudgeonly. I sort-of understand it in a way: > for many problems, for years, sticking with Linux and simple solutions > has proved superior to many commercial solutions to many problems, at > least in the small scope. And most people deal within the scope of > small and medium. And we've all experience the frustrating experience > of working in some nasty commercial environments. And we're attached > to those homemade solutions where we feel productive. But this is a > case where I'm witnessing the OSS community unable to think outside > the box. Docs is measurably better for shared collaborative editing > than anything else out there. It's not the same thing at all. You're overlooking at least the fact that using Google Docs forces people to use non-free software, in the form of minified JavaScript whose preferred form of modification is not available, onto any kind of users including simple readers of documents hosted there. I personally do not like being forced to use non-free software, especially when it is run on my own computer. You're free not to care about that. But I find weird that you find weird that people in the free/open source software community might have a problem with that. If not us, who? If you've the ability to fix this, please do. If not, please at least consider this as yet another argument against using Google Docs for documentation targeted at the FOSS community. Cheers. -- Stefano Zacchiroli . . . . . . . [email protected] . . . . o . . . o . o Maître de conférences . . . . . http://upsilon.cc/zack . . . o . . . o o Former Debian Project Leader . . . . . @zacchiro . . . . o o o . . . o . « the first rule of tautology club is the first rule of tautology club » -- --- You received this message because you are subscribed to the Google Groups "Ledger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout. -- --- You received this message because you are subscribed to the Google Groups "Ledger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
