Eric Bailey

I'm having some issues with Protocol Buffers and am considering this for a real project. Are there any caveats I should be aware of before attempting to use this library...

In LFE, people seem to strongly dislike like the distinction between `(let ...)`, as in: ```ocaml let x = 42 y = x + 1 (* Error: x is undefined)...

@rvirding, can you chime in here re: why LFE does it the same way as Alpaca currently does?

https://github.com/rvirding/lfe/blob/develop/src/lfe_macro_record.erl might be of interest here. Basically it takes record definitions and generates `make-` and `match-` macros (which we don't need in Alpaca) as well macros for getting all fields,...

I really like how Elm and Idris handle docstrings, especially the idrisexample syntax and markdown support.

I'm weary of heredocs encouraging overly verbose module files, but I suppose support does not equate to encouragement of verbosity. Maybe in a user guide or similar we could advocate...

An agreeable solution to me would be to add support for collapsing docstrings in [alpaca-mode](https://github.com/alpaca-lang/alpaca-mode).

@arkgil: I'm advocating using EDoc as the internal format. From that you can generate whatever HTML you want. I agree the default output is not so desirable.. The point of...

PS One issue I ran into when working toward translating LFE docs to EDoc format was that we deal with docs on an application/module level (as in, we know about...

Potentially informative references: - [`lfe_doc.hrl`](https://github.com/rvirding/lfe/blob/v1.2.1/src/lfe_doc.hrl) - [`lfe_doc.erl`](https://github.com/rvirding/lfe/blob/v1.2.1/src/lfe_doc.erl) - [Functions for accessing `"LDoc"` chunks from the shell](https://github.com/rvirding/lfe/blob/v1.2.1/src/lfe_shell.erl#L837-L891)