Do use file-based namespace declarations.

The only reason to use scoped-based namespace declarations is when there is more than one namespace define in a file. Since this condition should be avoided in production code, I propose the guideline: Do use file-based namespace declarations.

This wording, however, may not be clear enough. Perhaps Do use file-based namespace declarations and avoid scope-based namespace declarations.

I suspect that over time scope-based namespace declarations will disappear except in legacy code.

No file or test is named. Locate the guideline covering namespace declarations, compare its current wording with the proposed file-based preference, and update the guidance so the distinction from scope-based declarations is unambiguous.

Written by the indexing model from the issue text.