Subsystem description procedure
Subsystems are large areas of software worked on continuously by a stable set of people which often include contributions from many sources. As such, they can easily be confusing to neophyte or potential contributors. Consequently, if we desire more and better support from external contributors, we should expend extra effort to explain what subsystems exist, who maintains them, who has contributed to them, and what smaller components make them up.
Structure of a Description
A proper subsystem description currently consists of three things:
- A description page such as Security.
- This page should describe why the subsystem exists, what components it contains, and how to get in touch with the people who work on it.
- The description page should belong to Category:Subsystems.
- A credits page such as Security credits.
- A README file in software component in the subsystem linking to the subsystem description page and perhaps also including contact information for the current maintainers.