Support EEP 48 (compiling code documentation for use in Erlang etc)

[lpil]

[J3RN]

Better yet, we should support EEP 48 so that our documentation can be viewed from Erlang, Elixir, LFE, etc shells. The actual organization and storage of this information will be trivial if tedious, but the larger challenge will lie in updating the parser to retain //// and /// comments instead of discarding them.

[lpil]

Agreed, the parser rework will be the fiddly bit.

RE EEP 48, last I looked into this there was some suggestion of Erlang using a -doc("..."). attribute, I wonder if that is usable yet.

[J3RN]

It appears that EDoc supports special %% @doc ... comments, alongside other more specific constructs such as %% @author ..., which it can then compile into the EEP 48-compliant "chunks".

[lpil]

Ah here we are, found it -> https://github.com/erlef/build-and-packaging-wg/issues/32

[J3RN]

Sadly José's Google Doc appears to have been deleted (or else I specifically don't have access 😅) and the EEP hasn't yet been created.

[lpil]

Closing as we don't have a clear idea of what to do here.