Provide titles to rules/conventions that are "context-free" (i.e. they make sense even when read outside of the surrounding text/page where they appear), and suggestive (i.e. provide an appropriate summarization of the rule).
E.g. the current title of MC-R2 ("On goals and scope"), and MC-R3 ("On modularisation") are not very good titles. We could make them "Recommendations on goals and scope" and "Recommendations on modularisation", or f you want to be more specific "Define a clear goal and scope" and "Consider breaking up complex domain models in modules"
Other titles that could be improved, include: GC-R4, GC-R5, PC-R6, but in general all rule titles should be reviewed and improved where necessary.
costezki
commented
1 year ago
Provide titles to rules/conventions that are "context-free" (i.e. they make sense even when read outside of the surrounding text/page where they appear), and suggestive (i.e. provide an appropriate summarization of the rule).
E.g. the current title of MC-R2 ("On goals and scope"), and MC-R3 ("On modularisation") are not very good titles. We could make them "Recommendations on goals and scope" and "Recommendations on modularisation", or f you want to be more specific "Define a clear goal and scope" and "Consider breaking up complex domain models in modules"
Other titles that could be improved, include: GC-R4, GC-R5, PC-R6, but in general all rule titles should be reviewed and improved where necessary.