V: Provide a full syntax diagram of V

[gslicer]

As long we have no up-to date language reference besides of the tutorial, a => Syntax Diagram could possibly help to write V code and keep up with ongoing changes in the V language specs (e.g. recently the signed integer type "i32" has been made an invalid type in favor of its former alias "int").

Ideally this diagram would be build automatically from source and be updated each time one compiles V using the native V-compiler (ASCII-art representation would be more than sufficient for now), and be used to display it on the vlang.io homepage.

What do you think, would this be valuable for people learning V or working with it?

[medvednikov]

All new breaking changes will be taken care of by vfmt. User code will be automatically upgraded.

[gslicer]

All new breaking changes will be taken care of by vfmt. User code will be automatically upgraded.

All right, so at least this sounds like backwards-compatibility to older version's source code which is good!

How about the learning aspect of the issue? Perhaps some kind of EBNF would be a good start at least?

[medvednikov]

How about the learning aspect of the issue? Perhaps some kind of EBNF would be a good start at least?

I'm all for it :)

Unfortunately I can't work on it right now. My hands are full.

[medvednikov]

Also: https://github.com/vlang/v/issues/288

[gslicer]

Unfortunately I can't work on it right now. My hands are full.

I understand, I will close this in favor of #288 then for now - thx for pointing to it

[gslicer]

Just in case someone digs up this issue one day. there is an other example how a language specification could be displayed: https://ziglang.org/documentation/master/#Grammar

[cristian-ilies-vasile]

FYI.
Welcome to Railroad Diagram Generator!
https://www.bottlecaps.de/rr/ui

[hachi8833]

I prefer to PEG notation for describing V specification! https://github.com/pointlander/peg