[erlang-questions] Erlang documentation -- a modest proposal
Mon Sep 26 14:13:51 CEST 2016
In your initial comment, you said "If I see a typo", not "if my wife sees a
> I suppose your wife isn't very used to downloading the 240 MBytes,
> unpacking them, fixing the file and publishing the change, either. This was
> the scenario for which I suggested a simpler alternative.
> There is an even better way, actually, even if it still requires a Github
> account in its current form. I don't remember where I saw it first, but I
> use it for the erlide documentation (which I am well aware that is lacking
> in all other respects): each generated page has at the bottom the message
> shown below, where the link opens the source file (markdown, in this case)
> from which it was generated in the on-line Github editor. This is something
> that could be added to the OTP docs too (but hand-editing Docbook XML is
> not as much fun as it sounds like :-\ )
The XML markup used for the Erlang documentation is not Docbook. We use our
own DTDs with much more lightweight markup than Docbook.
> > Did you find errors in the documentation? Do you have improvements to
> suggest? Suggest edits!
> best regards,
/Kenneth, Erlang/OTP, Ericsson
> erlang-questions mailing list
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the erlang-questions