Arbital is a really neat website design intended to help readers learn concepts.
Unlike e.g. Wikipedia, it can present the same content at different levels of complexity and dynamically show you the prerequisites for learning a given topic!
https://arbital.com/learn/Arbital_author_basics
miniblog.
Related Posts
JSON is too small (no comments) and YAML is too big (many string syntaxes, relatively few implementations).
TOML is in the sweet spot for complexity, but I agree this syntax is by far the most confusing part.
TOML 1.1 improves it at least:
"Minus 100 points", an article on deciding how to add features C#, remains one of the best introduction to PL design principles I've seen: https://docs.microsoft.com/en-us/archive/blogs/ericgu/minus-100-points
(Design is hard, combinatorial complexity grows easily, saying "no" needs to be a default.)
1
Writing a REPL that evaluates-as-you-type, keeping the UI responsive and staying defensive against runaway memory usage: https://scattered-thoughts.net/writing/making-live-repls-behave/
It's a really hard problem for PLs, but even this small live demo has a lot of complexity.