-
-
Notifications
You must be signed in to change notification settings - Fork 11
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
23 changed files
with
407 additions
and
443 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,66 +1,57 @@ | ||
| --- | ||
| title: FAQs | ||
| title: "Frequently Asked Questions" | ||
| permalink: /docs/faq/ | ||
| --- | ||
|
|
||
| Frequently asked questions: | ||
|
|
||
| ### Where can I download the Eclipse Plugin? | ||
| Open the [Eclipse Marketplace](https://marketplace.eclipse.org/content/context-mapper) in Eclipse, search for "Context Mapper", and press "Install". | ||
|
|
||
| Alternatively, use the following Eclipse update site and install the plugin in Eclipse via *Help -> Install New Software...* (copy past the update site link) | ||
| Alternatively, use the following Eclipse Update site and install the plugin in Eclipse via *Help -> Install New Software...* (copy past the update site link). | ||
|
|
||
| Update Site: [https://dl.bintray.com/contextmapper/context-mapping-dsl/updates/](https://dl.bintray.com/contextmapper/context-mapping-dsl/updates/) | ||
|
|
||
| ### How do I create an Eclipse project with a new CML model to start modeling my Context Map? | ||
| Consult the page [Create CML Model](/docs/getting-started-create-project/) which describes how you setup your project to get started with modeling CML | ||
| Context Maps. | ||
| Consult the page [Create CML Model](/docs/getting-started-create-project/). It describes how to setup your project to get started with modeling CML Context Maps. | ||
|
|
||
| ### How do I create a new context map? | ||
| Just create a file with the file extension **cml** (Context Mapping Language). Take a look at our example to get an idea how it looks like: [https://github.com/ContextMapper/context-mapper-examples](https://github.com/ContextMapper/context-mapper-examples) | ||
| Just create a file with the file extension **.cml** (Context Mapping Language). Take a look at our example to get an idea how the file content should look like: [https://github.com/ContextMapper/context-mapper-examples](https://github.com/ContextMapper/context-mapper-examples). Let the code completion and other editor features in Eclipse guide you while completing the map and modeling Bounded Contexts. | ||
|
|
||
| ### Which DDD Patterns are supported by CML? | ||
| Have a look at our [CML Reference - Introduction](/docs/language-reference/) page. You will find all patterns supported by CML there. | ||
|
|
||
| ### Which combinations of Strategic DDD Patterns are allowed? | ||
| Have a look at the page [Language Semantic Model](/docs/language-model/) which introduces the semantic model of our DSL and lists the implemented semantic checkers. | ||
|
|
||
| ### Which transformations can I apply to my CML model? | ||
| Currently you can generate [MDSL](https://socadk.github.io/MDSL/) (micro-)service contracts providing assistance regarding how your | ||
| system can be implemented in an (micro-)service-oriented architecture, [Service Cutter](http://servicecutter.github.io/) input | ||
| to get suggestions for service cuts or new bounded context, and you can generate UML ([PlantUML](http://plantuml.com/)) diagrams | ||
| out of your CML. The following pages explain the generators in detail: | ||
|
|
||
| * [Generate Graphical Context Maps](/docs/context-map-generator/) | ||
| * [Generate PlantUML Diagrams](/docs/plant-uml/) | ||
| * [Generate MDSL (Micro-)Service Contracts](/docs/mdsl/) | ||
| * [Generate Service Cutter Input Files](/docs/service-cutter/) | ||
| * [Generate Arbitrary Text Files](/docs/generic-freemarker-generator/) (with Freemarker templates) | ||
|
|
||
| ### How can I refactor my CML model? | ||
| The Context Mapper tool provides a set of architectural refactorings which you can apply to your model. Find more information and all | ||
| available refactorings [here](/docs/architectural-refactorings). | ||
| Have a look at the page [Language Semantic Model](/docs/language-model/). It introduces the semantic model of our DSL and lists the implemented semantic checkers. | ||
|
|
||
| ### Where do I find a documentation regarding the tactic DDD syntax to specify a bounded context in detail? | ||
| The tactic DDD part of our DSL is based on the [Sculptor DSL](http://sculptorgenerator.org/). However, you can find a short introduction | ||
| and examples how you can detail your bounded contexts on the pages [Aggregate](/docs/aggregate/) and [Tactic DDD Syntax](/docs/tactic-ddd/). | ||
| If you are interested in more details and all features, we refer to the [Sculptor documentation](http://sculptorgenerator.org/documentation/advanced-tutorial). | ||
|
|
||
| ### I have other questions not listed here. How can I contribute? | ||
| If you have any questions not answered by our documentation page, we are happy if you create an issue in our documentation [repo](https://github.com/ContextMapper/contextmapper.github.io/issues). Of course, PR's are always welcome as well. | ||
|
|
||
| Your [contribution](/getting-involved/) is welcome! | ||
| The tactic DDD part of our DSL is based on the [Sculptor DSL](http://sculptorgenerator.org/). We provide a short introduction and examples how you can detail your bounded contexts on the pages [Aggregate](/docs/aggregate/) and [Tactic DDD Syntax](/docs/tactic-ddd/). If you are interested in more details and all features, we refer to the [Sculptor documentation](http://sculptorgenerator.org/documentation/advanced-tutorial). | ||
|
|
||
| ### How do I validate all CML models (*.cml files) in my Eclipse project? | ||
| The CML models are validated when you save the *.cml automatically, if _"Build Automatically"_ is enabled in the _Project_ menu. | ||
| If it is not enabled you can validate all models by triggering _"Build All"_ in the _Project_ menu. | ||
| If it is not enabled, you can validate all models by triggering _"Build All"_ in the _Project_ menu. | ||
|
|
||
| ### Which transformations can I apply to my CML model? Which generators are available? | ||
| Currently you can generate [Microservice Domain-Specific Language (MDSL)](https://socadk.github.io/MDSL/) (micro-)service contracts providing assistance regarding how your system can be implemented in an (micro-)service-oriented architecture, [Service Cutter](http://servicecutter.github.io/) input to get suggestions for service cuts or new bounded context, and you can generate UML ([PlantUML](http://plantuml.com/)) diagrams out of your CML. The following pages explain the generators in detail: | ||
|
|
||
| * [Generate graphical Context Maps](/docs/context-map-generator/) | ||
| * [Generate PlantUML diagrams](/docs/plant-uml/) | ||
| * [Generate MDSL (micro-)service contracts](/docs/mdsl/) | ||
| * [Generate Service Cutter input files](/docs/service-cutter/) | ||
| * [Generate arbitrary text files](/docs/generic-freemarker-generator/) (with Freemarker templates) | ||
|
|
||
| ### How can I refactor my CML model? | ||
| The Context Mapper tool provides a set of [architectural refactorings](https://stefan.kapferer.ch/2019/09/05/service-decomposition-as-a-series-of-architectural-refactorings/) which you can apply to your model. Find more information and all | ||
| available refactorings [here](/docs/architectural-refactorings). | ||
|
|
||
| ### Does Context Mapper support Event Sourcing and CQRS? | ||
| The concepts behind event sourcing and CQRS do not require special modeling objects other than _DomainEvents_, which are supported by the Context Mapper DSL (CML). The syntax to specify | ||
| the domain models within Bounded Contexts is based on [Sculptor](http://sculptorgenerator.org/) which supports event-driven concepts. Have a look at our | ||
| [Event Sourcing and CQRS Modeling in Context Mapper](/docs/event-sourcing-and-cqrs-modeling/) page to learn how to model events in CML. | ||
| The concepts behind event sourcing and CQRS do not require special modeling objects other than _DomainEvents_, which are supported by the Context Mapper DSL (CML). The syntax to specify the domain models within Bounded Contexts is based on [Sculptor](http://sculptorgenerator.org/) which supports event-driven concepts. | ||
| Have a look at our [Event Sourcing and CQRS Modeling in Context Mapper](/docs/event-sourcing-and-cqrs-modeling/) tutorial to learn how to model events in CML. | ||
|
|
||
| ### Can I use Context Mapper to document Event Stormings? | ||
| Yes, the results of an Event Storming are based on the DDD concepts that are supported by Context Mapper. Have a look at our | ||
| [Model Event Storming Results in Context Mapper](/docs/event-storming/) tutorial that illustrates how Context Mapper can be used to | ||
| Yes, the results of an Event Storming are based on the DDD concepts that are supported by Context Mapper. Our | ||
| [Model Event Storming Results in Context Mapper](/docs/event-storming/) tutorial explains how Context Mapper can be used to | ||
| document an Event Storming. | ||
|
|
||
| ### I have other questions not listed here. How can I contribute? | ||
| If you have any questions not answered by our documentation page, we appreciate if you create an issue in our documentation [repo](https://github.com/ContextMapper/contextmapper.github.io/issues). Of course, Pull Requests (PRs) are always welcome too. | ||
|
|
||
| Active [contributions](/getting-involved/) are welcome as well! |
Oops, something went wrong.