Files, folders, and directories

note

This content describes how to format file names, folder names, and directories in documentation. For instructions on how to write file names for the Hexadocs platform, refer to File naming conventions.

Use clear and consistent formatting for files, folders, and directories to differentiate them from the rest of your text.

tip

For instructions on implementing this guidance with Markdown, refer to Confluence: Formatting documentation.

note

On the Learn platform, use bold font in lieu of monospaced until monospaced font is available on the platform.

File, folder and directory names

Format file names, folder names and directory paths in monospaced font.

When you refer to files, folders, and directories on the user’s system (including assets and files viewed in the Project window), make clear what the root folder is (where possible) and use backslashes to separate each folder.

Example file, folder, and directory names
Open example-file.png in the Editor.
Open the Assets folder in the Project window.
In the C:// drive, navigate to Users[YourName]\Download\UnityPackages.

File extensions

Write file extensions for file types in regular font. Include the preceding period.

For style information about when and how to refer to file types and file extensions, refer to File types and extensions.

File-naming conventions

Create file and folder names in accordance with Unity Asset Store: Assets Standards.

If a folder name is dependent on user input, place it inside square brackets. Use example names that are clearly examples, such as "[example-name]" or "[example-file]." Don’t use realistic names like "[night-scene]."

If a file is a document that begins with a heading or title, name the file to match that heading or title. For example: "SampleGameDesignDocument.pdf".