Consider adding commentaries from docs to grammar in spec

Kotlin / kotlin-spec

Kotlin Language Specification:

https://kotlinlang.org/spec

Apache License 2.0

387 stars 80 forks source link

Consider adding commentaries from docs to grammar in spec #92

Open belyaev-mikhail opened 3 years ago

belyaev-mikhail commented 3 years ago

The doc team expressed an idea to remove grammar from language documentation completely and just provide a link to the spec. This involves translating (and maybe rewriting to support the spec style) grammar comments from the docs to the spec grammar.

We need to devise some solution to do this both in the build (rewrite grammar-converter) and in the text.