Имена документов и файлов для удобной сортировки, поиска и длительного использования

Что это такое

Соглашение об именовании определяет для одной папки или одного класса документов, какие сведения входят в имя, в каком порядке, с какими разделителями и из каких символов. POSIX (указан в источниках) определяет переносимый набор символов имён файлов, состоящий из букв, цифр, точки, подчёркивания и дефиса, и отмечает, что ведущий дефис создаёт проблемы при передаче имён как аргументов командной строки. RFC 3339 (указан в источниках) замечает, что при расположении компонентов даты и времени по возрастанию точности строковый порядок совпадает с хронологическим, если используются одинаковые часовой пояс и точность. Указанные рекомендации Harvard по управлению данными по той же причине советуют даты YYYYMMDD, временные метки YYYYMMDDThhmm и ведущие нули в порядковых номерах.

Почему это важно

Имена читают в списках файлов, результатах поиска, URL, строках журналов и командных строках, обычно без содержимого. Имя, которое неправильно сортируется, требует кавычек или отличается от другого только регистром, при каждом использовании создаёт небольшие издержки. Имена опубликованных документов становятся ссылками; переименование разрывает эти ссылки.

Как применять

• Один раз определите компоненты и их порядок: {date}-{type}-{subject} для элементов, упорядоченных по времени (2026-09-15-incident-report-upload-failures.md), {subject}-{qualifier} для упорядоченных по идентификатору (invoice-template-v3.docx).
• Используйте переносимый набор символов, везде нижний регистр, дефисы между словами; если поля нужно разделять, используйте один разделитель между полями и другой внутри них и укажите, какие именно.
• Записывайте даты как YYYY-MM-DD (или YYYYMMDD, если дефисы используются в другом месте) и дополняйте порядковые номера нулями до фиксированной ширины (007).
• Обозначайте версии явно (v2, дата или хеш коммита), но никогда словами «final», «new» или «latest».
• Никогда не полагайтесь на регистр или пробелы; файловые системы без учёта регистра считают Report.md и report.md одним файлом, а пробелы везде требуют кавычек.
• Делайте имя коротким, а полное название помещайте внутрь документа; имя идентифицирует, содержимое описывает.
• Запишите соглашение в README в папке и переименовывайте инструментом контроля версий, чтобы история следовала за файлом.

Подводные камни

Даты DD-MM-YYYY, которые сортируются по дню. Символы вне ASCII, которые файловые системы нормализуют по-разному. Имена, кодирующие сведения, также хранящиеся в другом месте, и затем расходящиеся с ними. Переименование опубликованных файлов без перенаправления. Очень длинные имена, превышающие ограничения путей в некоторых инструментах.