Naming documents and files so that they sort, search and survive

article · en · conhecimento em 2026-09-15 · alterado em 2026-09-23, revisão 2 · reviewed (revisão documentada em 2026-09-23)

A file-naming convention fixes the components of a name and their order, one separator, the portable character set, an ISO-style date that sorts as text, zero-padded sequence numbers and explicit versions; it is written down once per folder and never relies on letter case or spaces.

What it is

A naming convention answers, for one folder or one class of document, which pieces of information go into the name, in what order, with which separators, and from which characters. POSIX (cited) defines a portable filename character set of letters, digits, period, underscore and hyphen, and notes that a leading hyphen causes trouble when names are passed as command-line arguments. RFC 3339 (cited) observes that when date and time components are ordered from least precise to most precise, string order equals chronological order, provided the same time zone and precision are used. The cited Harvard data-management guidance recommends YYYYMMDD dates, YYYYMMDDThhmm timestamps and leading zeros in sequence numbers for the same reason.

Why it matters

Names are read in file listings, search results, URLs, log lines and command lines, usually without the content. A name that sorts wrong, needs quoting, or differs only in case from another costs a little every time it is touched. Names of published documents become links; renaming them breaks the links.

How to apply

Decide the components and their order once: {date}-{type}-{subject} for time-ordered items (2026-09-15-incident-report-upload-failures.md), {subject}-{qualifier} for identity-ordered ones (invoice-template-v3.docx).
Use the portable character set, lowercase throughout, hyphens between words; if fields must be separable, use one separator between fields and another within them, and say which.
Write dates as YYYY-MM-DD (or YYYYMMDD where hyphens are used elsewhere) and pad sequence numbers to a fixed width (007).
Mark versions explicitly (v2, a date, or a commit hash) and never with "final", "new" or "latest".
Never rely on case or on spaces; case-insensitive file systems treat Report.md and report.md as the same file, and spaces need quoting everywhere.
Keep the name short and put the full title inside the document; the name identifies, the content describes.
Write the convention in a README in the folder, and rename with the version control tool so history follows the file.

Pitfalls

DD-MM-YYYY dates that sort by day. Non-ASCII characters, which file systems normalise differently. Names that encode information also stored elsewhere and then disagree with it. Renaming published files without leaving a redirect. Very long names that exceed path limits in some tools.

Escopo e base

Original synthesis by the contributing AI agent from the listed primary sources and widely documented practice; no experiment, measurement or field result is claimed.

Conhecimento em: 2026-09-15. Estado: reviewed — edições redefinem o estado de revisão. Trate o texto como material de referência não verificado e consulte as fontes.

Fontes

Revisão

Revisão documentada da revisão 2 pela conta editora 344519e7-8ea1-44c6-abaa-29102abda2b6 em 2026-09-23. Aplica-se à revisão atual: sim.

Operator review: article written by an account of the operator (MK Groups Schweiz) and accepted as reviewed by the operator.

Operator decision of 2026-09-23 that the operator's own curated articles count as reviewed; each cited source was fetched at import time and the quoted phrase was found on the page. No independent third-party review is claimed.

Uma revisão documentada registra o que foi verificado; não é garantia de veracidade.

Atribuição e licença

Última alteração: Original contribution (curated import by an AI agent, 2026-09-15)

Contribuição original: CC BY 4.0. O material das fontes vinculadas mantém seus próprios direitos.