Merge branch 'master' into feat-2114-add-required-field-management-c-sharp

Author: jonaslagoni

.all-contributorsrc

@@ -1023,6 +1023,35 @@
         "code",
         "test"
       ]
+    },
+    {
+      "login": "maxplatov",
+      "name": "maxplatov",
+      "avatar_url": "https://avatars.githubusercontent.com/u/14889696?v=4",
+      "profile": "https://github.com/maxplatov",
+      "contributions": [
+        "review"
+      ]
+    },
+    {
+      "login": "emmanuel-ferdman",
+      "name": "Emmanuel Ferdman",
+      "avatar_url": "https://avatars.githubusercontent.com/u/35470921?v=4",
+      "profile": "https://github.com/emmanuel-ferdman",
+      "contributions": [
+        "doc"
+      ]
+    },
+    {
+      "login": "jonjomckay",
+      "name": "Jonjo McKay",
+      "avatar_url": "https://avatars.githubusercontent.com/u/456645?v=4",
+      "profile": "https://jonjomckay.com",
+      "contributions": [
+        "code",
+        "bug",
+        "test"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.github/workflows/update-maintainers-trigger.yaml

@@ -0,0 +1,28 @@
+# This action is centrally managed in https://github.com/asyncapi/.github/
+# Don't make changes to this file in this repo as they will be overwritten with changes made to the same file in above mentioned repo
+
+name: Trigger MAINTAINERS.yaml file update
+
+on:
+  push:
+    branches: [ master ]
+    paths:
+      # Check all valid CODEOWNERS locations: 
+      # https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners#codeowners-file-location
+      - 'CODEOWNERS'
+      - '.github/CODEOWNERS'
+      - '.docs/CODEOWNERS'
+
+jobs:
+  trigger-maintainers-update:
+    name: Trigger updating MAINTAINERS.yaml because of CODEOWNERS change
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Repository Dispatch
+        uses: peter-evans/repository-dispatch@ff45666b9427631e3450c54a1bcbee4d9ff4d7c0 # https://github.com/peter-evans/repository-dispatch/releases/tag/v3.0.0
+        with:
+          # The PAT with the 'public_repo' scope is required
+          token: ${{ secrets.GH_TOKEN }}
+          repository: ${{ github.repository_owner }}/community
+          event-type: trigger-maintainers-update

README.md

@@ -9,7 +9,7 @@
 [![Discussions](https://img.shields.io/github/discussions/asyncapi/modelina)](https://github.com/asyncapi/modelina/discussions)
 [![Website](https://img.shields.io/website?label=website&url=https%3A%2F%2Fwww.modelina.org)](https://www.modelina.org)
 [![Playground](https://img.shields.io/website?label=playground&url=https%3A%2F%2Fwww.modelina.org%2Fplayground)](https://www.modelina.org/playground) <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-94-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-97-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 Your one-stop tool for generating accurate and well-tested models for representing the message payloads. Use it as a tool in your development workflow, or a library in a larger integrations, entirely in your control.
@@ -109,7 +109,7 @@ for (const model in models) {
 </td>
   </tr>
   <tr>
-    <td><b>Easily modify how models are <a href="./docs/constraints.md">constrained</a> into the output</b></td>
+    <td><b>Easily modify how models are <a href="./docs/constraints/README.md">constrained</a> into the output</b></td>
 
 <td>
 
@@ -444,6 +444,9 @@ Thanks go out to these wonderful people ([emoji key](https://allcontributors.org
       <td align="center" valign="top" width="14.28%"><a href="https://pike.github.io/"><img src="https://avatars.githubusercontent.com/u/43494?v=4?s=100" width="100px;" alt="Axel Hecht"/><br /><sub><b>Axel Hecht</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/commits?author=Pike" title="Code">💻</a> <a href="https://github.com/asyncapi/modelina/commits?author=Pike" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/tomdevroomen"><img src="https://avatars.githubusercontent.com/u/4637986?v=4?s=100" width="100px;" alt="Tom de Vroomen"/><br /><sub><b>Tom de Vroomen</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/commits?author=tomdevroomen" title="Code">💻</a> <a href="#example-tomdevroomen" title="Examples">💡</a> <a href="https://github.com/asyncapi/modelina/commits?author=tomdevroomen" title="Documentation">📖</a> <a href="https://github.com/asyncapi/modelina/commits?author=tomdevroomen" title="Tests">⚠️</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/memdal"><img src="https://avatars.githubusercontent.com/u/77838566?v=4?s=100" width="100px;" alt="memdal"/><br /><sub><b>memdal</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/commits?author=memdal" title="Code">💻</a> <a href="https://github.com/asyncapi/modelina/commits?author=memdal" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/maxplatov"><img src="https://avatars.githubusercontent.com/u/14889696?v=4?s=100" width="100px;" alt="maxplatov"/><br /><sub><b>maxplatov</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/pulls?q=is%3Apr+reviewed-by%3Amaxplatov" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/emmanuel-ferdman"><img src="https://avatars.githubusercontent.com/u/35470921?v=4?s=100" width="100px;" alt="Emmanuel Ferdman"/><br /><sub><b>Emmanuel Ferdman</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/commits?author=emmanuel-ferdman" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://jonjomckay.com"><img src="https://avatars.githubusercontent.com/u/456645?v=4?s=100" width="100px;" alt="Jonjo McKay"/><br /><sub><b>Jonjo McKay</b></sub></a><br /><a href="https://github.com/asyncapi/modelina/commits?author=jonjomckay" title="Code">💻</a> <a href="https://github.com/asyncapi/modelina/issues?q=author%3Ajonjomckay" title="Bug reports">🐛</a> <a href="https://github.com/asyncapi/modelina/commits?author=jonjomckay" title="Tests">⚠️</a></td>
     </tr>
   </tbody>
 </table>

docs/README.md

@@ -48,7 +48,7 @@ Details which different generator options are supported.
 ### [Presets](./presets.md)
 Goes more in-depth into how the preset system works, which enables full customization of generators.
 
-### [Interpretation of JSON Schema](./inputs/json_schema.md)
+### [Interpretation of JSON Schema](./inputs/JSON_Schema.md)
 Explains how a JSON Schema is interpreted to a data model.
 
 ### [Migration](./migrations/README.md)

docs/advanced.md

@@ -23,7 +23,7 @@ This document contains many of the advanced use-cases that you may stumble upon
 
 This example shows us how to generate each model in the same file
 
-Check out this [example out for a live demonstration](../examples/generate-all-models-within-same-file).
+Check out this [example out for a live demonstration](../examples/generate-all-models-within-the-same-file).
 
 ## Generate models to separate files
 
@@ -97,7 +97,7 @@ Check out this [example out for a live demonstration](../examples/change-type-ma
 
 ## Changing the constrain rules
 
-When moving from a [MetaModel](./internal-model.md#the-meta-model) to a [ConstrainedMetaModel](./internal-model.md#the-constrained-meta-model) it means we bind the input to a specific output. That output has specific constraints that the input MUST adhere to, [read more about this here](constraints.md).
+When moving from a [MetaModel](./internal-model.md#the-meta-model) to a [ConstrainedMetaModel](./internal-model.md#the-constrained-meta-model) it means we bind the input to a specific output. That output has specific constraints that the input MUST adhere to, [read more about this here](constraints/README.md).
 
 There can be multiple reasons why you want to change the default constrain rules, and therefore you can form them to your needs.
 

docs/constraints/README.md

@@ -1,5 +1,5 @@
 # Constraints
-Because we cannot control what is provided as input, we must constrain the internal model to be valid for the output ([read more about the process here](./internal-model.md)). What is considered valid entirely depends on the output so each have their own set of rules.
+Because we cannot control what is provided as input, we must constrain the internal model to be valid for the output ([read more about the process here](../internal-model.md)). What is considered valid entirely depends on the output so each have their own set of rules.
 
 As an example lets consider TypeScript as an output. Consider the model name, which are a simple string, but a string which can contain ANY characters and formats. Some of the constraints we have found for the naming of a model are:
 
@@ -16,18 +16,18 @@ class 1name {}
 
 There are many rules as such, but to get the full description about the default constraints here:
 
-- [C++](./constraints/Csplusplus.md)
-- [C#](./constraints/CSharp.md)
-- [Dart](./constraints/Dart.md)
-- [Go](./constraints/Go.md)
-- [Java](./constraints/Java.md)
-- [JavaScript](./constraints/JavaScript.md)
-- [Kotlin](./constraints/Kotlin.md)
-- [PHP](./constraints/PHP.md)
-- [Python](./constraints/Python.md)
-- [Rust](./constraints/Rust.md)
-- [Scala](./constraints/Scala.md)
-- [TypeScript](./constraints/TypeScript.md)
+- [C++](./Cplusplus.md)
+- [C#](./CSharp.md)
+- [Dart](./Dart.md)
+- [Go](./Go.md)
+- [Java](./Java.md)
+- [JavaScript](./JavaScript.md)
+- [Kotlin](./Kotlin.md)
+- [PHP](./PHP.md)
+- [Python](./Python.md)
+- [Rust](./Rust.md)
+- [Scala](./Scala.md)
+- [TypeScript](./TypeScript.md)
 
 Even though there are many of these constraints, there might be reasons you want to customize the behavior to make it suit your use-case. Therefore each of the constraint rules can be overwritten completely and allow for you to implement your own behavior.
 

docs/contributing.md

@@ -118,7 +118,7 @@ To make it easier to contribute a new generator, and to avoid focusing too much
 4. Add your [generator to the generator index file](../src/generators/index.ts).
 
 Now it's time to adapt the template into what ever it is you are generating:
-1. Adapt the [constraint logic](../src/generators/template/constrainer) and the [type constraints](../src/generators/template/TemplateConstrainer.ts) based on what is allowed within your output. Read more about the constraint logic [here](./constraints.md).
+1. Adapt the [constraint logic](../src/generators/template/constrainer) and the [type constraints](../src/generators/template/TemplateConstrainer.ts) based on what is allowed within your output. Read more about the constraint logic [here](./constraints/README.md).
 2. Add all of the reserved keywords that the models must never generate in the [Constant file](../src/generators/template/Constants.ts).
 3. Adapt/create the first renderers. The template by default include two renderers, one for rendering enums and one for classes, but you can create what ever renderers makes sense. For example in Rust it's not called class but struct, so therefore its called a `StructRenderer`.
 4. Adapt the file generator and the rendering of the complete models to fit your generator.

docs/internal-model.md

@@ -148,7 +148,7 @@ This means that if you accessed `EnumValueModel.key` you would get `something% s
 
 How and what are constrained?
 
-The answer to this question is not straightforward, cause each output has unique constraints that the meta models must adhere to. You can read more about [the constraint behavior here](./constraints.md).
+The answer to this question is not straightforward, cause each output has unique constraints that the meta models must adhere to. You can read more about [the constraint behavior here](./constraints/README.md).
 
 ```mermaid
 ---

docs/other-tools.md

@@ -23,7 +23,7 @@ Here is some of the noticeable differences with Modelina that is nice to know be
 1. Modelina does not care much about the input, and support a range of them with no real limitation. I.e. supporting AsyncAPI, OpenAPI, ..., etc, see [supported inputs for more information](../README.md#features).
 2. Modelina does not care about output language, i.e. it's not only Java that is supported, see the full list of [supported outputs here](../README.md#features).
 3. Modelina does not hardcode specific features such as serialization libraries i.e. Jackson, Gson, ..., or validation annotations. Instead we use [presets](./presets.md) to control what is being generated to never be limited by hardcoding. Read more about which [serialization libraries we support for Java here](./languages/Java.md#generate-serializer-and-deserializer-functionality).
-4. Modelina does not care which types you want generated (primitive types, long integers, etc), this can be [controlled by the constrainer](./constraints.md). Read more about how to [change the type mapping](./constraints.md#type-mapping).
+4. Modelina does not care which types you want generated (primitive types, long integers, etc), this can be [controlled by the constrainer](./constraints/README.md). Read more about how to [change the type mapping](./constraints/README.md#type-mapping).
 5. Modelina is part of Linux Foundation and is therefore a neutral ground for collaboration.