Simplicity, Abstraction, and the Modern Website: 10 Years Later

Self-Documenting in Drupal

  • Use clear, descriptive names and prefixes for CMS objects (and use the 'description' field):

    • Instead of 'AP Menu' use 'Sidebar Menu: Academic Programs'

    • Instead of 'Events' use 'Front Page Block: Upcoming Events'

  • Avoid ambiguous names like 'page', 'profile', 'about', etc.

  • Self-document code: modules, plugins, themes, template files, CSS, JavaScript, etc.:

    • Use descriptive identifiers and inline comments for anything not self-evident.