The basic layout of the Gentoo repository is as follows:
metadata/. Most of the listed contents are not kept directly in the main git tree but instead auto-generated or included from other repositories as part of the Git to Rsync process.
layout.confexists in the main git tree.
metadata/glsa/and news items in
distfiles/. This is not included in the main git tree, but it will be found on most user systems.
packages. Again, this is found on user systems but not in the main git tree.
Things that do not belong in the tree:
Naming rules for distfiles are more lenient, but for interoperability their
filenames are restricted to the printable ASCII range excluding SPACE, i.e.,
U+0021 to U+007E (see also
GLEP 31). Any characters that have a special meaning in Bash or in
SRC_URI should also be avoided. If necessary, upstream files can be
Software-wise, in general all of the following should be met in order for a package to be included in the tree:
If a package is undeveloped or unmaintained upstream, it can be extremely difficult to get problems fixed. If a package does not have an active upstream, the developers who add the package to the tree must ensure that they are able to fix any issues which may arise.
Sometimes upstream may have a reason for not wanting their package included in the tree. This should be respected.
package.maskuntil things calm down, or better yet make them available as overlay ebuilds.
If we can't patch packages as necessary ourselves, we end up relying entirely upon upstream for support. This can be problematic, especially if upstream are slow at fixing things. We don't want to be in the situation where we can't stable a critical package because we're still waiting for a closed-source vendor to get their act together.
Similarly, not being able to mirror and distribute tarballs ourselves makes us rely entirely upon upstream mirrors. Experience has shown that these are often extremely unreliable, with files changing, moving or vanishing at random.