You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Current documentation is not well structured, with clear tabs and sections, to guide a new user through the language ecosystem. The expected outcome of this issue is to reorganize the whole documentation in a way that gives a clear path to users on:
how to get started
introduction
language concepts
examples
how/where to reach out
contributing & code of conduct
blog posts
The documentation is using mkdocs material theme. Other options can be considered, as long as good reasons are given (easy of deploying updated documentation, easy of writing new content, easy of adding new features, easy of maintaining and debugging, good aesthetics). Check the docs/ folder on this very repository to see what features are enabled and its content.
Expected behavior
Define and perform documentation reorganization (website tree structure, individual pages, and even text can be moved around).
Defining the documentation engine and which features to include, remove, improve, and moving the content to the new engine (should it be a new one) or adapt content to the new features.
Description
Current documentation is not well structured, with clear tabs and sections, to guide a new user through the language ecosystem. The expected outcome of this issue is to reorganize the whole documentation in a way that gives a clear path to users on:
The documentation is using mkdocs material theme. Other options can be considered, as long as good reasons are given (easy of deploying updated documentation, easy of writing new content, easy of adding new features, easy of maintaining and debugging, good aesthetics). Check the
docs/folder on this very repository to see what features are enabled and its content.Expected behavior
Note: documentation website visual identity is defined on issue #94; here it's only about the content.