Web standards and guidelines

File and directory names

File and directory names must conform to the technical specification for the syntax of URLs, defined in RFC 2396 Uniform Resource Identifiers (URI): Generic Syntax.

In particular, file and directory names must:

  • only use alphanumeric characters (A to Z, a to z, 0 to 9), and the following characters: - _ . ! ~ * ’ ( )
  • use the slash character / to separate hierarchical parts of a file path.

This ensures that file names can be easily referenced in URLs and are portable between operating systems.

Currently, the LTS web service is case-insensitive with regard to directory and file names.

Underscores in directory and file names are not recommended because:

  • users can get confused between an underscore and a hyphen
  • underlined text (hyperlinks, for example) frequently hides the underscore and users may assume that there is a space between the words in the directory or file name.

It is essential that developers adopt a consistent file naming convention and it is recommended that developers should use lower case for all directory or file names.