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 markus. I'm arguing against simple
markup if the only people who use this are developers.
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!
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.
>
> 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.
Kind regards
Jan
------------------------------------------------------------------------------
_______________________________________________
Owfs-developers mailing list
Owfs-developers@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/owfs-developers
