Architecture Decision Records

What is an Architectural Decision Record (ADR)?

An Architectural Decision Record (ADR) is a document that describes a choice that our team makes about any significant aspect of the software architecture that we are planning to build. Each ADR describes the architectural decision which includes both the context, the decision, the status and the consequences.

The Web Communications Technology (WebTech) team uses architectural decision records to streamline technical decision-making for any meaningful software development project or decision that is made.

Additional ADR Notes

Architecture Decision Records Listed by most recent first
Title Status Topics Author Created on
Alt text on directory photos disabled by default Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Drupal Stephanie
Enable nofollow search engine behavior for PDF files uploaded to web servers by default Proposed Accessibility, Diversity, Equity and Inclusion (ADEI), Procedure, Web Development Max
Western web themes won't provide slideshow/carousel patterns Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Ashlar, Design System, Drupal, Web Development, WordPress Carly
Avoid using the "enable sticky header" option in Drupal views Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Ashlar, Drupal, Web Development Carly
Git Versioning, Tagging & Release Schedule for Ashlar Accepted Ashlar, Drupal, Procedure, Web Development Stephanie
Embedded iframes need to be preceded by a heading Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Video, Web Development Max
Visually hidden styles are only used on regular text if necessary Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Design System, Web Development Carly
Ellipses on card components should not be used Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Design System, Drupal, PatternLab, Web Components/Custom Elements Max
View accordion titles use <div role="button"> as base markup Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Drupal, PatternLab, Web Development Carly
Event dates should display year Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Design System, Drupal, Web Components/Custom Elements, Web Development, WordPress Stephanie
Define heading structure protocol Proposed Accessibility, Diversity, Equity and Inclusion (ADEI) David
Department Directory Update Procedure Accepted Procedure Max
Drupal projects will use semantic versioning Accepted Drupal Nigel
Ashlar components integrated into wwugenesis should use an adapter. Proposed Web Components/Custom Elements, WordPress Alex
Views with exposed filters should display result count Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Drupal Carly
Web patterns and content will use semantic HTML5 where possible Accepted Accessibility, Diversity, Equity and Inclusion (ADEI), Design System, Web Development Carly
Documents will be added through the Media Library Proposed Accessibility, Diversity, Equity and Inclusion (ADEI), Drupal Jean
Custom Elements will be used as the components for Ashlar Accepted Design System, Web Components/Custom Elements Stephanie
Docusaurus will be used as the component library for Ashlar Accepted Ashlar, Design System, Drupal, PatternLab, Web Components/Custom Elements, Web Development Stephanie