Drasil icon indicating copy to clipboard operation
Drasil copied to clipboard

Documenting program families

Open bmaclach opened this issue 6 years ago • 2 comments

As we add more design choices, we will need to decide on a way to document the available choices and dependencies between them.

This issue based on discussion in #1862 starting from https://github.com/JacquesCarette/Drasil/issues/1862#issuecomment-542713288.

bmaclach avatar Oct 17 '19 19:10 bmaclach

Another dependency between design choices is that Doxygen output verbosity only matters if comments are turned on.

I wonder how closely this issue is related to #1861? Surely any taxonomy we develop for the design choices would reflect the dependencies between choices. Could it be that the result of #1861 can solve this issue as well, i.e. the design choice "language" could act as the documentation of the program families?

bmaclach avatar Oct 25 '19 18:10 bmaclach

We might want to look at 'feature diagrams' and 'feature algebra' for modeling simpler dependencies. Yes, this is definitely related to the taxonomy, which will be structured.

JacquesCarette avatar Oct 25 '19 20:10 JacquesCarette