<commit_before>.. _filename-conv:

=========================
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 example, ``technical-considerations-multi-site.rst``.
<commit_msg>Points to reason for why hyphens are the convention for RST file names<commit_after>.. _filename-conv:

=========================
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 <https://support.google.com/webmasters/answer/76329>`_.

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

{'fraction_non_alphanumeric': 0.20913705583756345, 'fraction_numerical': 0.005076142131979695, 'mean_word_length': 5.4868421052631575, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1786279', 'n_tokens_mistral': 277, 'n_tokens_neox': 240, 'n_words': 98}