<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Sep 27, 2016 at 1:03 PM, Martin Karlsson <span dir="ltr"><<a href="mailto:martin@admitsolutions.co.nz" target="_blank">martin@admitsolutions.co.nz</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr">Hi guys,<br><br><div><div class="gmail_extra"><span class=""><div>> Interesting would be to know how many % of the users that actually are using the man and pdf pages.<br></div></span><div>The man pages is the erlang documentation I use the most. In fact I Iike them so much I had to reply to this thread to reduce the risk of them going away :). They are much quicker than anything if you have a console based work-flow. I even miss the man pages for all external libraries. I would love if there was a common erlang documentation system making it easy for external libraries to produce the same style and type of documentation as the official documentation.<br></div></div></div></div></blockquote><div><br></div><div>erl_docgen included in OTP is such a toll with which you can build documentation in the same style as the official one. Of course the documentation for erl_docgen itself could be improved as well:) But we are using it for the </div><div>OTP documentation and the intention has always been that it can be used for the users applications as well. </div><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div class="gmail_extra"><div><br></div><div>I am not overly attached to a documentation system but there are a few that does conversion to lots of formats with good quality, for example sphinx which can generate html, latex, man pages, epub among others.<br><br></div><div>A final comment regarding html generated documentation. Please don't rely on javascript for more than enhancing the experience. I see lots of modern html documentation which doesn't display all data (for example code examples) or can't do navigation without javascript.<br><br></div><div>Cheers, <br></div><div>Martin<br></div><div></div></div></div></div></blockquote><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div class="gmail_extra"><div>/Kenneth Erlang/OTP , Ericsson</div><div><br></div><br></div></div></div>
<br>______________________________<wbr>_________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/<wbr>listinfo/erlang-questions</a><br>
<br></blockquote></div><br></div></div>