All ADRs
A collection of software design choices that address architecturally significant requirements
- ADRs 71
- Collaborators 51
- Disciplines 39
- Always provide editors control over image style cropping
- Test ADR for /bump command testing
- Automate checking for uncommitted files
- Use data-drupal-selector to target form elements in JavaScript
- Use the feature branch git workflow
- Respect prefers-reduced-motion for all animations and transitions
- Always pin GitHub Actions to a commit hash
- Use Stylelint
- Use Tagify for entity autocomplete widgets in Drupal
- Use composer audit in automated checks for known security vulnerabilities
- Use PHPStan for PHP code static analysis at level 6
- Only allow developers and site administrators access to the default Drupal files listing
- Use `access_unpublished` for password-protected pages
- Use the term "microcontent" to describe embeddable content from the same website
- Use 'drush deploy' when building Drupal sites
- Self-host Third-Party Static Assets
- Layer elements deliberately with stacking contexts
- The main branch of a project should always be ready to deploy to production
- Use Renovate for third-party dependency updates
- Use SVG view box instead of width and height
- Use human-readable names as exposed filter identifiers in Views
- Enforce Twig coding standards with automatic linting
- Use ImageMagick with Drupal
- Avoid using jQuery
- Use relative units in CSS for resizable content
- Use only one h1 on each page
- Use description template for upstream patches in composer
- Use 11ty to manage the ADRs
- Document project setup in README.md
- Use SVGs for icons
- Do not use placeholder text in form fields
- Order content type form fields based on content priority
- Load JavaScript as external resource with defer attribute
- Standardize the order of steps when building a Drupal site
- Load JavaScript as external resource with async and defer attributes
- Use Typed Entity to encapsulate business logic in dedicated classes
- Leverage view modes when rendering entities
- Use [ticket-id]--[short-description] in feature branch names
- Use identical cache backends on development environments
- Use JavaScript strict mode
- Use SMACSS to organize CSS within projects
- Use TypeScript for pure JavaScript development
- Use CSS Logical Properties
- Do not add the Metatag field to the node form
- Use gatsby-theme-adr to manage the ADRs
- Use Claro for the Drupal administration theme
- Use inclusive language in code and technical writing
- Use Simple Add More to improve editorial experience
- Use Type Tray to improve editorial UX
- Configure Composer Patches to Use `-p2` as `patchLevel` for Drupal core
- Store Composer Patches configuration in composer.json
- Use local copies of patch files
- Break composer install if patches don't apply
- Use dedicated accounts for service integrations
- Always hide non-translatable fields on translation forms
- Lock entity language on edit forms
- Consistently name entity fields
- Use PHPUnit for unit testing PHP code
- Composer patches configuration and best practices
- Always use typehints in new PHP code
- Block the Drupal user 1 account in production environments
- Confirm Drupal site configuration is always in a default state
- Use DDEV for local environments
- Use strict types in PHP code
- Use settings.php for environment overrides and local settings
- Stage File Proxy for static files
- Avoid command aliases and short options
- Define the order of steps when building a Drupal site
- Environment Indicator
- Use Log4brains to manage the ADRs
- Record architecture decisions