Suggested Documentation change
We should ensure all our old aggregate documentation has an equivalent entity description.
The entity description should not just be a copy-paste plus rename, obviously.
It should refer to the new infra components and means to configure as well.
Currently, the command-handlers.adoc contains the explanation of entities, disregarding the *adoc. files in the commands/pages/modeling folder. However, I think we should rename modeling to entities and replace those files one by one. This will simplify the command-handlers.adoc explanation, as the would refer to the entity pages whenever somebody needs an entity.
Although I view this as a must in the long run, given the tasks at hand for milestone 5.1.0, I have set it to a should. Priority is subject to change.
Suggested Documentation change
We should ensure all our old aggregate documentation has an equivalent entity description.
The entity description should not just be a copy-paste plus rename, obviously.
It should refer to the new infra components and means to configure as well.
Currently, the
command-handlers.adoccontains the explanation of entities, disregarding the*adoc.files in thecommands/pages/modelingfolder. However, I think we should renamemodelingto entities and replace those files one by one. This will simplify thecommand-handlers.adocexplanation, as the would refer to the entity pages whenever somebody needs an entity.Although I view this as a must in the long run, given the tasks at hand for milestone 5.1.0, I have set it to a should. Priority is subject to change.