franjo_mindek
Joined 1 year ago
Karma
22
Submissions
5
Member since
May 28
Recent submissions
Comment · 1 year ago
Comment · 1 year ago
We recently did explore Phoenix as an inspiration, and we really liked how docs work in the Elixir ecosystem.
We can't really copy everything, but we could copy e.g. automatic docs generation for the API (and JS/TS has solutions for that that even Phoenix uses e.g. https://hexdocs.pm/phoenix/js/index.html).
I love the fact that API docs and code comments can't get out of sync that way.
Still parts of the docs have to be handmade, and those are usually not supported directly by the ecosystem, so you have to build your own solutions.
1) Frees us from maintaining a DSL (parsing, LS, ..).
2) Uses something familiar to most web developers.
3) Actually expands our configuration features. E.g. with TypeScript we can change the configuration depending on env vars.
Though we want to keep the same level of abstraction as in DSL. Doing that with great DX is what we want to tackle.