File names
“If you think your boss is stupid, remember: You wouldn’t have a job if he was any smarter.” — John Gotti
Table of contents
Extension letter
Refer to file type names as uppercase, but use lowercase for file extensions.
Use full form file extensions (e.g.: .jpeg
over .jpg
), unless modified by a specific platform or tool.
Check out our company profile in the attached PDF file.
Attachment: company_profile.pdf
Separate indices
When referencing a series of files, use a combination of the filename and index with a separator.
├─ links
│ ├─ graph_1.svg
│ ├─ graph_2.svg
│ └─ graph2_1.svg
├─ blog_1.md
└─ blog_2.md
Whitespace symbol
Use an underscore to separate words when the file is part of source code. Hyphens are reserved for files on the web.
├─ avoiding_cliches.jd
└─ quick_lesson1-4.md