Is there a template to document the "Ubiquitous language" in DDD?

Navigation
6

I wonder if there is a template to follow for documentation of linguagem ubíqua or Ubiquitous language DDD . (ubiquitous language)

Explaining better, would be something that would facilitate the search for some resource in the project, thus avoiding the fragmentation or creation of duplicate resources.

I hope I'm not talking bullshit because I'm new to the area.

    
asked by anonymous 17.06.2015 / 03:23

2 answers

1

In Implementing Domain-Driven Design - Vaughn Vernon book he suggests as an experiment for ubiquitous language documentation the following:

  • Draw images of the physical and conceptual domain and label them with names and actions. These designs are mostly informal, but may contain some aspects of formal software modeling. Home Even if your team works with a formal model such as the Unified Modeling Language (UML), you should avoid any kind of ritual that stifles discussions and chokes the creativity of the final language you are looking for.
  • Create a glossary of terms with simple definitions. List alternative terms, including those that are promising, those that are not, and why. As you include definitions, you may not be able to help, but develop reusable phrases for the Language because you are forced to type in the language of the domain.
  • Even if you do not like the idea of a glossary, you can still capture some kind of documentation with important software concepts. Again, the goal here is to bring additional terms and phrases important to the domain language.
  • Since only one or a few team members can capture the Glossary or other written documents, the rest of the team should review the resulting sentences. Not always, if ever, will there be consensus with the captured linguistics, so agility and heavy fixes are expected.
    •   

    These are basic ideals with first steps in shaping a language   ubiquitous that fits into your domain. However, this   absolutely not the model you are developing. It's just the   beginning of the ubiquitous language that should be   source code for your system.

        
    19.10.2015 / 21:50
    3

    In the health field (a fine example of complex systems) we use an "Ubiquitous language" to describe models using the ADL (Archetype Description Language) language. This language is defined by the openEHR standard, which provides a number of tools for documentation and model discussion among domain experts.

    This is specific to the health area, but I believe it is a great template for what you are looking for.

    You can find material on language specification and models under development at link

    You'll also find the models under development at link

    I'm not a specialist in Eric Evans's theories, but I believe there's a lot of adherence to what was proposed by Sam Heard and Thomas Beale.

    Here is a short article I wrote about developing archetypes: Methodological Development of Archetypes

    Abs

        
    21.06.2015 / 06:52
    What is the difference between OO and DDD? Group values from an array in PHP