Closed Lotes closed 4 months ago
PR Preview Action v1.4.6 :---: Preview removed because the pull request was closed. 2024-05-14 11:37 UTC
@Lotes I wrote a tutorial about keywords as identifiers in https://github.com/eclipse-langium/langium-website/pull/219, but it is not yet merged. Maybe it belongs to "Recipes"? It could be seen as a tutorial as well, but it is not related to Minilogo, therefore "Minilogo tutorial" would not fit as category.
@JohannesMeierSE
I would put it under recipes, since it is not really learning the workflow, it is some kind of feature you want to talk about.
The Minilogo tutorial is also some kind of learning + multiple recipes, and I think maybe we should adapt it to fit more with the workflow. On the other hand... each project has its own challenges and therefore differs from the core workflow.
I got some ideas in detail:
Regarding "Our Workflow":
For the "Workflow diagram":
Nevertheless, I like your clear steps a lot and I think, they will help newcomers a lot! My comments target only some details of the updated documentation structure.
Thank you, @JohannesMeierSE . I made all these changes.
Add a hint on names for resolving scope. The name is the key to resolve cross-references.
I reorganized the documentation in this PR. I do not want to delete any existing pages, but sometimes they are a bit long and misleading. Most of them are fine for me. I also added a learning section where (new) the basic workflow with Langium gets explained.