Michael Hatherly

> indexing every subdirectory of the current directory It's meant to index everything from the package's `src` directory. Were you running Docile on something produced by `Pkg.generate` or just a...

Already implemented. Not importing `helpdb.jl`, but rather commandeering the REPL's `?` mode.

Nope, you're not missing anything. My closing comment was just a bit vague. What's actually implemented is [this](https://github.com/MichaelHatherly/Lexicon.jl/blob/2d54864a2824c252d05c276638ca3fc8ab5c26e4/src/query.jl#L201-L204) and [this](https://github.com/MichaelHatherly/Lexicon.jl/blob/2d54864a2824c252d05c276638ca3fc8ab5c26e4/src/query.jl#L286-L298). Lexicon intercepts the `?` mode in the REPL, displays the...

Not sure how pandoc would do with this. Would definitely be worth investigating.

That's really cool! Does pypandoc include a pandoc binary with it or does that need to be downloaded separately?

@one-more-minute, I've also been leaning towards embedding the metadata in the docstring itself recently myself. `meta` was a nice idea, but once I started writing out some actual docstrings with...

That's true. Might be worth not tying ourselves to a specific syntax yet, and rather see what people begin to use naturally for denoting "metadata" in their docstrings.

Writing the "human-readable" signature as the first line is a good idea. When a docstring is quite long having the signature at the top can help with context while reading....

> what's the syntax to attach it to a specific signature (after definition time)? I've not come across a need to attach docs to a `Method` after definition, but I...

> @one-more-minute: This is roughly along the lines I've been thinking. It'd be easy to also have e.g. > > @hayd: if you instead provide return_type (the doc system generates,...