<div dir="ltr">Thank you for bringing this up. An improvement to the presentation of the Erlang documentation is very much needed.<div><br></div><div>I have started looking at this myself sometime ago, here is what I gathered:</div><div>    • The OTP documentation is using erl_docgen which is mostly XSLT based</div><div>    • Edoc is not that much used in OTP, the applications that do rely on it, use a custom layout (otpsgml_layout) to generate output that can be consumed by erl_docgen.</div><div>    • Experimented with adding a modern HTML5 output to erl_docgen here: <a href="https://github.com/asabil/otp/tree/feature/html5-docs" target="_blank">https://github.com/asabil/otp/tree/feature/html5-docs</a> but this proved itself challenging.</div><div>    • Started working on a modern doclet for edoc, based on the ex_doc layout: <a href="https://bitbucket.org/asabil/edoc-modern">https://bitbucket.org/asabil/edoc-modern</a></div><div><br></div><div><br></div><div>Hope this helps.</div><div><br></div><div>Cheers,</div><div>Ali</div><br><div class="gmail_quote"><div dir="ltr">On Wed, Mar 2, 2016 at 1:05 PM Jean Parpaillon <<a href="mailto:jean.parpaillon@free.fr" target="_blank">jean.parpaillon@free.fr</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">mkdocs is used for generating documentation suitable for, for instance,<br>
<a href="http://readthedocs.org" rel="noreferrer" target="_blank">readthedocs.org</a> platform.<br>
<br>
I've had started a mkdocs doclet module some time ago but it is stalled<br>
now. At that time, I was not really familiar with xmerl, and this is<br>
one of the reasons I've not continued.<br>
<br>
Anybody interested in going on ?<br>
<a href="https://github.com/erocci/edoc_mkdocs" rel="noreferrer" target="_blank">https://github.com/erocci/edoc_mkdocs</a><br>
<br>
<br>
Cheers,<br>
Jean<br>
<br>
<br>
Le mercredi 02 mars 2016 à 16:37 +0900, zxq9 a écrit :<br>
> On Wednesday 02 March 2016 11:15:04 Leo Liu wrote:<br>
> > On 2016-03-01 23:53 +0000, Federico Carrone wrote:<br>
> > > I am sure this is not a priority for most developers. However I<br>
> > > do<br>
> > > think this type of things are important for some newcomers.<br>
> ><br>
> > I think it is very important to the Erlang community. The bar has<br>
> > been<br>
> > raised so high that there is no excuse not to make the<br>
> > documentation<br>
> > pleasant to read. Hope there is a way to facilitate your<br>
> > contribution.<br>
><br>
> I've wished I had time to do the same. If you actually *do* have time<br>
> to<br>
> work on this it would be great (and if you need a hand, ASK -- I've<br>
> mentioned it more than once, just never got around to doing<br>
> anything).<br>
><br>
> You may be able to create a pull request directly against the OTP<br>
> project on github. Maybe not.<br>
><br>
> Anyway, good luck!<br>
><br>
> -Craig<br>
> _______________________________________________<br>
> erlang-questions mailing list<br>
> <a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
> <a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/listinfo/erlang-questions</a><br>
--<br>
Jean Parpaillon<br>
--<br>
Director @ OW2 Consortium<br>
OCCIware Strategic Orientation Committee Chairman<br>
Research Engineer @ Inria<br>
--<br>
Phone: +33 6 30 10 92 86<br>
im: <a href="mailto:jean.parpaillon@gmail.com" target="_blank">jean.parpaillon@gmail.com</a><br>
skype: jean.parpaillon<br>
linkedin: <a href="http://www.linkedin.com/in/jeanparpaillon/en" rel="noreferrer" target="_blank">http://www.linkedin.com/in/jeanparpaillon/en</a><br>
<br>
_______________________________________________<br>
erlang-questions mailing list<br>
<a href="mailto:erlang-questions@erlang.org" target="_blank">erlang-questions@erlang.org</a><br>
<a href="http://erlang.org/mailman/listinfo/erlang-questions" rel="noreferrer" target="_blank">http://erlang.org/mailman/listinfo/erlang-questions</a><br>
</blockquote></div></div>