On 8 September 2016 at 09:20, Jan Kandziora <j...@gmx.de> wrote: > Am 08.09.2016 um 09:58 schrieb Colin Law: >> On 7 September 2016 at 23:03, Jan Kandziora <j...@gmx.de> wrote: >>> ... >>> In reality, we don't need this "simple" markup when all the people who >>> are contributing to the documentation are developers. >> >> Not necessarily true. I have recently been guided on this list as to >> how to interface 1-wire devices to a Raspberry Pi and owserver. I >> would gladly add an application note to a wiki detailing how to do >> this provided it was easy to do, so using something like Markup. >> > Stop. I'm not arguing against simple markup. I'm arguing against simple > markup if the only people who use this are developers.
Stop what? My "not necessarily" was about your suggestion that all contributors would be developers. Perhaps I misunderstand and you meant "if all the people..." rather than "when all the people". Whatever, I was just pointing out that I am not a developer and would like to contribute. However I am not arguing for Markup specifically, just something simple. > > Face it, simple markup alone will not give you any contributors. Hell, > non-developer documentation contributors don't want to bother with > markup at all! Wikipedia doesn't seem to have problems getting contributors. > > What we need is an interface that makes it easy for *anyone* to > contribute to the documentation. If we don't have that, we could just > stick to HTML. Agree with first sentence. Don't know about second. One final point, the important thing is that the information is there and accessible, how pretty it looks is of little importance. > >> >> I am sure there are many developers who have would find it difficult, >> or at least tedious, to write html. Surely very few do that >> regularly nowadays. >> > Really? I'm that old-school? Can't be. Fraid so :) Colin ------------------------------------------------------------------------------ _______________________________________________ Owfs-developers mailing list Owfs-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/owfs-developers
