Какие части имени различают документы
Имя файла должно отвечать на практические вопросы: к какому событию относится документ, какая это встреча или стадия, какие участники указаны, какая версия перед глазами и в каком формате сохранён файл. Эти сведения помогают различить похожие протоколы одного турнира.
Идентификатор первичного источника полезно хранить в карточке досье, а при коротком и безопасном формате можно добавить в имя. Его не следует заменять неясным словом «новый» или «финал», если таких файлов может быть несколько.
Пример собственной схемы
Вымышленный пример: для события «Kubok-Severa», полуфинала между «Orion» и «Vektor» можно использовать имя «kubok-severa_sf_orion-vektor_protocol_v02.pdf». Части имени читаются так: «kubok-severa» — событие, «sf» — согласованное сокращение стадии, «orion-vektor» — участники, «protocol» — тип документа, «v02» — вторая сохранённая версия, «pdf» — формат.
Если первоначально получен файл без исправлений, его можно назвать «kubok-severa_sf_orion-vektor_source_v01.pdf», а рабочую таблицу — «kubok-severa_sf_orion-vektor_work_v01.csv». Метки source и work разделяют роли файлов, а номер версии относится к версии конкретного файла, а не к предполагаемой достоверности результата.
Правила устойчивого имени
- Выберите постоянный порядок компонентов: событие, стадия, участники, тип, версия, расширение.
- Для сортировки по времени при необходимости добавляйте дату в формате ГГГГ-ММ-ДД, только если она известна как дата документа или матча.
- Используйте один набор допустимых разделителей, например дефисы внутри составных названий и подчёркивания между крупными частями.
- Увеличивайте версию при сохранении изменённой копии: v01, v02, v03.
- Записывайте в досье адрес исходника, момент фиксации и изменения по схеме «было/стало».
Что не следует включать
Личные имена, адреса, номера телефонов и иные личные данные не нужны для различения спортивного протокола. Не следует помещать в имя и неподтверждённые оценки вроде «верный» или «ошибка судьи»: они не описывают происхождение файла и могут смешать факт с предположением.
Дата без указания, что именно она обозначает, также может запутать. Если это момент фиксации документа, а не дата матча, его лучше хранить отдельным полем в досье; час без даты и смещения UTC не задаёт момент однозначно.