·¬ÇÑÉçÇø

Naming conventions

When it comes to naming conventions in Cascade, there are a few very important rules to follow:

System name

This is the name of the folder or file. It will become part of the URL.

Acceptable:

  • Lowercase letters
  • Numbers
  • Hyphens (-)

Never use:

  • Dates (application2014.pdf)
  • Spaces
  • Underscores (_). Links are usually underlined, and underscores are difficult to see.
  • Special characters, such as exclamation points (!), question marks (?), and percent signs (%).

Try to keep the system name descriptive, short and simple. For example, when creating a block (i.e., accordion or imagewrapper) use a descriptive system name that indicates the page it will be added to such as cheese-image-wrapper.

Why shouldn't I use a date in the system name?

When you need to upload a new version of a document, use Cascade to upload a new version without changing the name.  This way, everyone who has linked to your document or has bookmarked it will automatically get the new version. You can also see previous versions of the document in Cascade.

If you delete application2014.pdf and upload application2015.pdf, all links will to this new file will be broken.

See Updating a document tutorial for further details.

Display name

The display name should be in sentence case (see ) and it should be descriptive, short and simple. 

  • The display name for a folder appears in your site's navigation.
  • The display name for a page appears in the titlebar of your browser.
  • The display name for a block needs to be entered, but it does not appear on your site.