Names such as xcom, catalogue_of_life are too specific, and don't give readers an immediate high-level understanding of the domain they're looking at.
Proposed Solution
Introduce top-level packages called e.g. gaming, biology.
Each project should sit directly inside its package, so for example gaming would contain a bunch of XCOM files and a README.md that talks about the XCOM Example.
If two or more projects come under the same top-level domain, we should introduce subpackages for these projects (e.g. xcom, pokemon, etc.)
Problem to Solve
Names such as
xcom,catalogue_of_lifeare too specific, and don't give readers an immediate high-level understanding of the domain they're looking at.Proposed Solution
Introduce top-level packages called e.g.
gaming,biology.Each project should sit directly inside its package, so for example
gamingwould contain a bunch ofXCOMfiles and aREADME.mdthat talks about the XCOM Example.If two or more projects come under the same top-level domain, we should introduce subpackages for these projects (e.g.
xcom,pokemon, etc.)