TactDoc: generate reference documentation for Tact source code

[novusnota]

Basic idea follows similar formats, see JSDoc, JavaDoc or dart doc (the tool I think it should be based off of) — to be able to write documentation comments for functions, contracts, structs, etc., such that those comments would later be used to automatically generate API documentation from.

The documentation can be generated in HTML, using a static site generator, like Starlight from Astro, which would also enable Tact users to host their docs using Github Pages right from their repos!

This can be made into a standalone repo, say tact-doc, which would provide all the necessary tooling. And then, that documentation generation tool will be included into the upcoming general Tact CLI.

[0kenx]

Or rustdoc

[novusnota]

Initial prototype (using awk from GNU coreutils) was done by a community member @0kenx: https://github.com/microcosm-labs/tact-tools/tree/main/tactdoc. It's a nice first step! 🔥

[novusnota]

Great page in Elixir docs on writing documentation, adding here for future reference in our docs and future pages, such as Effective Tact or something :)

https://hexdocs.pm/elixir/writing-documentation.html