Update versions and readmes

Author: georghinkel

packages/generator-anytext/README.md

@@ -1,5 +1,35 @@
-# NMF Package Generator
+# NMF AnyText Generator
 
-This [Yeoman](https://yeoman.io) generator is used to create a new [GLSP](https://langium.org/) extension for VS Code.
+This [Yeoman](https://yeoman.io) generator is used to create a new [AnyText](https://github.com/NMFCode/NMF/) extension for VS Code. AnyText is a language workbench with an incremental packrat parser supporting left recursions, so you do not have to worry about left recursion or an interaction between lexer and parser when designing your language.
 
-Please read the documentation to get started, as soon as this becomes available.
+## Prerequisites
+
+AnyText requires a .NET 8 or .NET 9 SDK to be installed. To install it, follow the [instructions](https://github.com/dotnet/core/blob/main/release-notes/9.0/install.md) provided by Microsoft. Then, the generator itself can be installed via NPM. We recommend a systemwide installation.
+
+```bash
+npm install generator-anytext --global --save-dev
+```
+
+## Using the generator
+
+The code generator scaffolds a new AnyText project. You can start it via the command line as follows:
+
+```bash
+yo anytext
+```
+
+This will ask you a range of questions, like the name of your language and a repository link. Based on this information, the code generator will generate a new directory with the following artifacts already set up for you:
+
+* An AnyText grammar document with an example grammar
+* A file to manually fine-tune editor services for the generated parser
+* A C# project that creates an LSP server of your grammar
+* A Visual Studio Code extension that integrates the LSP server
+* Visual Studio Code launch configurations such that you can easily debug your VS Code extension
+
+These artifacts are set up such that they integrate with each other. For example, the build directory of the LSP server is exactly where the VS Code extension is expecting it. Because the code generator also compiles the sources, you can start the extension straight away. Also, you can immediately use `vsce` to pack your extension into a deployable VSIX file.
+
+The extension project also contains scripts that allow you to easily regenerate the grammar and metamodel code once you did some changes.
+
+## Launching the new extension
+
+Because the code generator produces launch configurations for Visual Studio Code, you can easily start the extension via the *Run and Debug* section of Visual Studio Code when opening the newly created directory in Visual Studio Code.

packages/generator-anytext/templates/README.md

@@ -12,14 +12,22 @@ This folder contains two subdirectories:
 To get started with your VS Code Extension, we suggest the following steps:
 
 1. **Create the grammar definition.** To support this task, download the Anytext extension from the marketplace, if you haven't already done so.
-2. **Generate the code.** To generate the code, download the code generator as a .NET tool
-   `dotnet tool install nmf-anytextgen --global`
-   Afterwards, the code generator can be executed anywhere using `anytextgen`. You can see the documentation how to generate the code using `anytextgen help`.
-3. **Adjust the grammar.** The template already contains a manual extension of the generated code. Use this file to override the default behavior of the LSP server and adjust it to your needs.
-4. **Debug the extension.** You can start your VS Code extension right from VS Code when opening the *vscode* folder. The template is configured to give you a *Run Extension* launch configuration. Running the extension in debug will pop up a window asking you which Visual Studio window you want to use to debug the LSP server.
+2. **Adjust the grammar.** The template already contains a manual extension of the generated code. Use this file to override the default behavior of the LSP server and adjust it to your needs. To generate the code, the generated `package.json` contains two NPM scripts:
+   * `npm run generate-parser` regenerates the parser. Use this script whenever you make changes to your grammar for these changes to become effective.
+   * `npm run generate-metamodel` regenerates the metamodel. Use this script whenever you make changes to the abstract syntax of your DSL.
+3. **Adjust the editor services.** AnyText is built in such a way that you can easily extend the functionality of the generated language code and extend or customize it. As an example, the template includes a custom code lens and a specification that the abstract syntax element `Person` should be rendered with the symbol kind object. Note that the LSP is strict on the possible symbol kinds, so you have to chose from what LSP provides.
+4. **Debug the extension.** You can start your VS Code extension right from VS Code. The template is configured to give you a *Run Extension* launch configuration. Running the extension in debug will pop up a window asking you which Visual Studio (or other IDE) window you want to use to debug the LSP server.
 5. **Repeat.** Your grammar will probably not fit all your needs on the first attempt. Repeat the previous steps until you are happy with the result.
 
 ## Install your extension
 
 * To start using your extension with VS Code, copy it into the `<user home>/.vscode/extensions` folder and restart Code.
-* To share your extension with the world, read the [VS Code documentation](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) about publishing an extension.
+* To share your extension with the world, read the [VS Code documentation](https://code.visualstudio.com/api/working-with-extensions/publishing-extension) about publishing an extension. The extension is already prepared to be packaged using `vsce pack`.
+
+## Troubleshooting
+
+The code generator should already have installed the AnyText code generator as a global .NET tool. If this did not work for some reason, you can install it manually:
+
+`dotnet tool install nmf-anytextgen --global`
+
+Afterwards, the code generator can be executed anywhere using `anytextgen`. You can see the documentation how to generate the code using `anytextgen help`.

packages/generator-anytext/templates/backend/LanguageName.manual.cs

@@ -8,5 +8,20 @@ public partial class PersonRule
         {
             public override SymbolKind SymbolKind => SymbolKind.Object;
         }
+
+        public partial class GreetingRule
+        {
+            protected override IEnumerable<CodeLensInfo<Greeting>> CodeLenses
+            {
+                get
+                {
+                    yield return new CodeLensInfo<Greeting>
+                    {
+                        Title = "Greet",
+                        Action = (g, args) => _ = args.ShowNotification($"Hello, {g.Greeted.Name}!")
+                    };
+                }
+            }
+        }
     }
 }

packages/generator-anytext/templates/backend/LanguageNameLspServer.csproj

@@ -11,7 +11,7 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="NMF-AnyText-LSP" Version="2.0.416" />
+    <PackageReference Include="NMF-AnyText-LSP" Version="2.0.420" />
   </ItemGroup>
 
   <ItemGroup>