WDD 131: Dynamic Web Fundamentals

W01 Learning Activity: Naming Conventions

Overview

When working on the web, various factors—such as the browser, protocols, operating system, and programming languages—can influence how files behave. While many of these are out of your control, you can keep your work consistent and manageable by following standard file and folder naming conventions.

Prepare

• The file and folder naming conventions outlined in this lesson will be considered 'best-practice' rules for this course. These rules should be applied to all files and folders created in your course work.

  Note that most organizations have their own file management guidelines and best practices, including conventions for naming files, folders, and other workflows. These conventions may vary from one organization to another.

Naming Conventions

You will be expected to follow these naming conventions throughout the course.

• Use all lowercase letters, such as products.html

  Platforms and systems handle case sensitivity differently. Case sensitivity is an important concept to understand when managing files and folders.

• Do NOT use spaces in file and folder names. Use hyphens instead, such as design-document.html

  Spaces are handled inconsistently across systems and tools, so avoid them. A URL cannot contain a literal space; a space must be percent-encoded as "%20", which is hard to read. If you want visual separation in a name, use hyphens instead.

• Do NOT use special characters, e.g., <,>, \, /, #, ?, !

  Special characters often mean specific things to computers, so do not use them in the naming of files and folders.

• File and folder names should be as short and meaningful (semantic) as possible. For example, use winter-scene-sm.png rather than image13-v123523brokenbranchlifeimagery w200x200.png

  Short names save you, other developers, and site visitors from having to remember long complicated names for files and folders. When meaningful, names can also help predict the purpose or nature of the file or folder contents.

• In this class, the standard folder names for our sites/subfolders are:
  • styles – Folders with this name contain CSS files.
  • images – Folders with this name contain images.
  • scripts – Folders with this name contain JavaScript files.