Many times I've heard people complaining about different aspects of the
Official Erlang documentation, one thing that I find interesting is the fact
that the Erlang documentation is really complete and detailed, so I decided to
dedicate some time to other parts, to get familiar with it I decided to start
with an "easy" one, it's presentation.

The problem I found at first was that to see the results of my changes to
db_html.xsl I had to do a clean and build from scratch, which involved
recompiling erlang itself, taking a lot of time.

Later I found a way to only build the docs again by forcing a rebuild:

make -B docs

But this still involves building the pdf files which is the part that takes the
most time, I haven't found a target that will only build the html files, if you
know how or want to try to add it in the make file it would be great.

With this knowledge I started improving the docs, I will cover the main things
I changed.

The ones I couldn't figure out a semantic class I added a generic one to
help people spot them in the xsl document by inspecting the generated files

Clicable titles for standard sections with anchors for better linking

Improve table styling

Old Tables

New Tables

Improve applications page

Old Applications List

New Applications List

Improve modules page

Old Modules List

New Modules List

Add "progressive enhanced" syntax highlighting

At the bottom of the page there's a javascript file loaded, if successful it
will load the syntax highlighter module and css and then style all the code
blocks in the page, if it fails to load, is blocked or no js is enabled then
the code blocks will have a default styling provided by CSS.

The markup was not modified in any way to add this feature.

Make code tokens easier to differentiate from standard text

The previous style for inline code was a really light italic font, I changed it
to monospace but it was hard to distinguish, so I got some inspiration from
slack and surrounded the inline code words in a light box to make them stand
out.

Indent Exports and Data Types' section bodies

Old Data Types and Exports Sections

New Data Types and Exports Sections

This is all for now, I have some other ideas for future improvements but they
involve changes to the documentation so I will submit them separatedly.