[RFC]: Parse documentation

[zarubaf]

Ideally, when able to also process comments, we can automatically parse documentation. Let's start by gathering some ideas here:

• Document module hierarchy
• ~Markdown comments at top of file, similar to Rust /// and //!.~
• Port descriptions

[zarubaf]

• Function documentation
• Enum documentation
• Deprecated annotation