File naming and structure

File naming conventions

To indicate the hierarchical type of files for filenames:

• Follow a page-based, topical approach to file naming and do not apply any special prefixes.

• Use hyphens as space delimiters for search optimization.

For example, technical-considerations-multi-site.rst.

Directory structure

For better organization, use subdirectories to organize the files by a particular grouping such as project or topic.

Common practices include:

• Figure subdirectory includes images (both PNG and SVG source files).

• Sample subdirectory contains samples of source code and configuration files.

• Chapter subdirectory stores all sections included in one chapter with the parent file located in the top-level directory.

This documentation, is a derivative of RST conventions by OpenStack, used under CC BY.