search

eclipse-langium / langium-website

Source of langium.org
https://langium.org/
MIT License
15 stars 35 forks source link

Add Tutorials for Building a Language from A-Z #86

Closed montymxb closed 1 year ago

montymxb commented 2 years ago

This PR adds 7 new tutorials to our documentation. These tutorials are focused on guiding a user from getting a default language produced via the yeoman generator, all the way to a complete language running in the web with generation. These tutorials are all written around MiniLogo to provide a concrete example from one guide to the next.

This is quite a lot of tutorials, and a lot of new material, so reviews, corrections, improvements would be greatly appreciated 📚 .

In particular, I'm really interested in knowing how this flows, and whether the progression of tutorials (and their topics) makes sense.

EDIT: Revised from 'guides' to 'tutorials', given the strict continuity between each of these.

Lotes commented 2 years ago

I was wondering why only one guide is linked to the documentation (inside of the preview deployment). Forgotten or by intent? EDIT: I see that other pages are on draft state. Maybe it is better to do one PR per page, so you do not work too intensive on this and are more focused.

montymxb commented 1 year ago

Just a quick note, the netlify preview seems to be missing these guides. This seems to be related to #65.

msujew commented 1 year ago

@montymxb They seem to be there, the ToC entries are just missing.

montymxb commented 1 year ago

@msujew I have no problem with that, would save rewriting parts to make them more general. They do make sense as they are connected together, so that would work just fine.

montymxb commented 1 year ago

Side note: Removed the draft flag from the remaining pages, that was why they weren't showing up on the netlify preview (production build).