From 8c1dd399a4bf02288ee192281277b4fa265b2e83 Mon Sep 17 00:00:00 2001 From: Nathen Harvey Date: Tue, 30 Dec 2025 10:31:04 -0500 Subject: [PATCH] feat: add a summary to each item in the "DORA research archives" list. Adds a brief summary to each item in the research archives list on the research home page. These summaries provide a quick overview of the focus for each year or section. Changes include: - Added `archive_summary` to the front matter of all research archive pages (AI, 2014-2025). - Refactored `research_archives.html` to dynamically generate the list and display the summary. - Updated `research.scss` to: - Hide summaries on mobile and narrow desktop screens (< 1000px) to prevent horizontal scrolling. - Show summaries on wider screens. - Enforce a fixed width for labels on wide screens to ensure vertical alignment of the summary text. --- hugo/content/ai/_index.md | 1 + hugo/content/research/2014/_index.md | 1 + hugo/content/research/2015/_index.md | 1 + hugo/content/research/2016/_index.md | 1 + hugo/content/research/2017/_index.md | 1 + hugo/content/research/2018/_index.md | 3 +- hugo/content/research/2019/_index.md | 1 + hugo/content/research/2020/_index.md | 1 + hugo/content/research/2021/_index.md | 23 ++++--- hugo/content/research/2022/_index.md | 7 +- hugo/content/research/2023/_index.md | 1 + hugo/content/research/2024/_index.md | 1 + hugo/content/research/2025/_index.md | 1 + .../dora-2025/assets/scss/research.scss | 18 +++++ .../layouts/partials/research_archives.html | 69 +++++-------------- 15 files changed, 63 insertions(+), 67 deletions(-) diff --git a/hugo/content/ai/_index.md b/hugo/content/ai/_index.md index 0f0d91ec..5b71475b 100644 --- a/hugo/content/ai/_index.md +++ b/hugo/content/ai/_index.md @@ -2,6 +2,7 @@ title: "Artificial Intelligence" date: 2025-11-26 draft: false +archive_summary: "AI is fundamentally reshaping software delivery and organizational performance." --- {{< report_feature diff --git a/hugo/content/research/2014/_index.md b/hugo/content/research/2014/_index.md index 627ee511..1b82d14f 100644 --- a/hugo/content/research/2014/_index.md +++ b/hugo/content/research/2014/_index.md @@ -5,6 +5,7 @@ draft: false research_collection: "2014" type: research_archives layout: single +archive_summary: "DevOps is a cultural shift, not just technical practices, that drives significant improvements in IT and organizational performance." --- diff --git a/hugo/content/research/2015/_index.md b/hugo/content/research/2015/_index.md index a691e7b7..d42c4d2c 100644 --- a/hugo/content/research/2015/_index.md +++ b/hugo/content/research/2015/_index.md @@ -5,6 +5,7 @@ draft: false research_collection: "2015" type: research_archives layout: single +archive_summary: "High-performing IT organizations consistently outperform their counterparts in terms of four key software delivery metrics." --- diff --git a/hugo/content/research/2016/_index.md b/hugo/content/research/2016/_index.md index 168fe851..b4167b69 100644 --- a/hugo/content/research/2016/_index.md +++ b/hugo/content/research/2016/_index.md @@ -5,6 +5,7 @@ draft: false research_collection: "2016" type: research_archives layout: single +archive_summary: "Integrating quality into every stage and adopting experimental product development drives higher performance." --- diff --git a/hugo/content/research/2017/_index.md b/hugo/content/research/2017/_index.md index 0673827e..e961da36 100644 --- a/hugo/content/research/2017/_index.md +++ b/hugo/content/research/2017/_index.md @@ -5,6 +5,7 @@ draft: false research_collection: "2017" type: research_archives layout: single +archive_summary: "Transformational leadership plays a key role in fostering a culture of high performance." --- diff --git a/hugo/content/research/2018/_index.md b/hugo/content/research/2018/_index.md index aa4cc80e..83b2817e 100644 --- a/hugo/content/research/2018/_index.md +++ b/hugo/content/research/2018/_index.md @@ -7,6 +7,7 @@ type: research_archives layout: single tab_order: "0" tab_title: "Overview" +archive_summary: 'Operational performance joins the metrics, and the "Elite" cluster is introduced to define the highest level of software delivery.' --- -2018 saw the release of the first Accelerate State of DevOps Report independently published by DORA. [Read the 2018 report here]({{< relref "dora-report/" >}}). \ No newline at end of file +2018 saw the release of the first Accelerate State of DevOps Report independently published by DORA. [Read the 2018 report here]({{< relref "dora-report/" >}}). diff --git a/hugo/content/research/2019/_index.md b/hugo/content/research/2019/_index.md index dc9ae23c..b6337552 100644 --- a/hugo/content/research/2019/_index.md +++ b/hugo/content/research/2019/_index.md @@ -7,6 +7,7 @@ type: research_archives layout: single tab_order: "0" tab_title: "Overview" +archive_summary: "Communities of practice outperform centers of excellence, while heavyweight change approval processes negatively impact performance." ---
diff --git a/hugo/content/research/2020/_index.md b/hugo/content/research/2020/_index.md index d13ca946..d7c4384f 100644 --- a/hugo/content/research/2020/_index.md +++ b/hugo/content/research/2020/_index.md @@ -6,6 +6,7 @@ research_collection: "2020" # SEM and survey questions are included via template: templates/research_archives/single.html, if specified in front matter. The data for survey questions can be found at data/survey_questions.json type: research_archives layout: single +archive_summary: "DevOps transformations deliver significant Return on Investment (ROI) across the entire organization." --- diff --git a/hugo/content/research/2021/_index.md b/hugo/content/research/2021/_index.md index 43c41c42..99acbabb 100644 --- a/hugo/content/research/2021/_index.md +++ b/hugo/content/research/2021/_index.md @@ -7,6 +7,7 @@ type: research_archives layout: single tab_order: "0" tab_title: "Overview" +archive_summary: "High-quality internal documentation is foundational for successfully implementing technical capabilities." --- In 2021, DORA did deep-dive investigations into security, reliability, documentation, and more. You can [read the 2021 report here]({{< relref "dora-report" >}}). Below are some of the analytical tools used in producing the report. @@ -15,20 +16,20 @@ In 2021, DORA did deep-dive investigations into security, reliability, documenta {{< image src="dora-report/2021-dora-accelerate-state-of-devops-report.png" url="dora-report" float="right" width="18em" border="1px solid #eee" >}} -#### The highest performers are growing and continue to raise the bar. -Elite performers now make up 26% of teams, and have decreased their lead times for changes to production. The industry continues to accelerate, and teams see meaningful benefits from doing so. +#### The highest performers are growing and continue to raise the bar. +Elite performers now make up 26% of teams, and have decreased their lead times for changes to production. The industry continues to accelerate, and teams see meaningful benefits from doing so. -#### SRE and DevOps are complementary philosophies. -Teams that leverage modern operations practices, outlined by our Site Reliability Engineering (SRE) friends, report higher operational performance. Teams that prioritize both delivery and operational excellence report the highest organizational performance. +#### SRE and DevOps are complementary philosophies. +Teams that leverage modern operations practices, outlined by our Site Reliability Engineering (SRE) friends, report higher operational performance. Teams that prioritize both delivery and operational excellence report the highest organizational performance. -#### More teams are leveraging the cloud and see significant benefits from doing so. +#### More teams are leveraging the cloud and see significant benefits from doing so. Teams continue to move workloads to the cloud and those that leverage all five capabilities of cloud see increases in software delivery and operational performance and organizational performance. Multi-cloud adoption is also on the rise so that teams can leverage the unique capabilities of each provider. -#### A secure software supply chain is both essential and drives performance. -Given the significant increase in malicious attacks in recent years, it is even more pressing for organizations to shift from reactive practices to proactive and diagnostic measures. Teams that integrate security practices throughout their software supply chain to deliver software quickly, reliability, and safely. +#### A secure software supply chain is both essential and drives performance. +Given the significant increase in malicious attacks in recent years, it is even more pressing for organizations to shift from reactive practices to proactive and diagnostic measures. Teams that integrate security practices throughout their software supply chain to deliver software quickly, reliability, and safely. -#### Good documentation is foundational for successfully implementing capabilities. -For the first time, we measured the quality of internal documentation and practices that contribute to this quality. Teams with high quality documentation are better able to implement technical best practices and perform better as a whole. +#### Good documentation is foundational for successfully implementing capabilities. +For the first time, we measured the quality of internal documentation and practices that contribute to this quality. Teams with high quality documentation are better able to implement technical best practices and perform better as a whole. -#### A healthy team culture mitigates burnout during challenging circumstances. -Team culture makes a large difference to a team's ability to deliver software and meet or exceed their organizational goals. Inclusive teams with a generative culture experienced less burnout during the COVID-19 pandemic. +#### A healthy team culture mitigates burnout during challenging circumstances. +Team culture makes a large difference to a team's ability to deliver software and meet or exceed their organizational goals. Inclusive teams with a generative culture experienced less burnout during the COVID-19 pandemic. diff --git a/hugo/content/research/2022/_index.md b/hugo/content/research/2022/_index.md index 2a7b7f8e..2883614f 100644 --- a/hugo/content/research/2022/_index.md +++ b/hugo/content/research/2022/_index.md @@ -7,6 +7,7 @@ type: research_archives tab_order: "0" tab_title: "Overview" layout: single +archive_summary: "The biggest predictor of an organization’s application-development security practices is cultural, not technical." --- In 2022, DORA continued its investigation into software development and operations, and the capabilities which drive performance. This year's deep-dive investigations included security, reliability, and culture. You can [download the 2022 report here]({{< relref "dora-report" >}}). @@ -19,7 +20,7 @@ High trust, low-blame cultures focused on performance were significantly more li #### The key variables that impact organizational performance tend to fall in the following categories: **Organizational and team culture** -High-trust and low-blame cultures tend to have higher organizational performance. Similarly, organizations with teams that feel supported through funding and leadership sponsorships tend to have higher organizational performance. Team stability and positive perceptions about one’s team also tend to lead to higher levels of organizational performance. Lastly, the companies that offer flexible work arrangements are the companies that tend to see high levels of organizational performance. +High-trust and low-blame cultures tend to have higher organizational performance. Similarly, organizations with teams that feel supported through funding and leadership sponsorships tend to have higher organizational performance. Team stability and positive perceptions about one’s team also tend to lead to higher levels of organizational performance. Lastly, the companies that offer flexible work arrangements are the companies that tend to see high levels of organizational performance. **Reliability** Both the practices we associate with reliability engineering and the extent to which people report meeting their reliability expectations are powerful predictors of high levels of organizational performance. @@ -30,9 +31,9 @@ Teams continue to move workloads to the cloud and those that leverage all five c #### Context matters DORA has long postulated that many of these effects depend on a team’s broader context. For example, a technical capability in one context could empower a team, but in another context, could have deleterious effects. -Software delivery performance’s effect on organizational performance depends on operational performance (reliability), such that high software delivery performance is only beneficial to organizational performance when operational performance is also high. Implementing software supply chain security controls like those recommended by the SLSA framework has a positive effect on software delivery performance, but only when continuous integration is firmly established as a capability. +Software delivery performance’s effect on organizational performance depends on operational performance (reliability), such that high software delivery performance is only beneficial to organizational performance when operational performance is also high. Implementing software supply chain security controls like those recommended by the SLSA framework has a positive effect on software delivery performance, but only when continuous integration is firmly established as a capability. Technical capabilities build upon one another. Continuous delivery and version control amplify each other’s ability to promote high levels of software delivery performance. Combining continuous delivery, loosely coupled teams, version control, and continuous integration fosters software delivery performance that is greater than the sum of its parts. #### Perceptions matter -Teams that recognize the need to continuously improve tend to have higher organizational performance than those that don’t. \ No newline at end of file +Teams that recognize the need to continuously improve tend to have higher organizational performance than those that don’t. diff --git a/hugo/content/research/2023/_index.md b/hugo/content/research/2023/_index.md index 13b6bb5e..2dd0d796 100644 --- a/hugo/content/research/2023/_index.md +++ b/hugo/content/research/2023/_index.md @@ -7,6 +7,7 @@ type: "research_archives" tab_order: "0" tab_title: "Overview" layout: single +archive_summary: "User-centricity predicts 40% higher performance, while quality documentation amplifies the impact of technical capabilities." --- diff --git a/hugo/content/research/2024/_index.md b/hugo/content/research/2024/_index.md index 11705c11..e69869f6 100644 --- a/hugo/content/research/2024/_index.md +++ b/hugo/content/research/2024/_index.md @@ -7,6 +7,7 @@ tab_order: "2" tab_title: "Overview" type: "research_archives" layout: single +archive_summary: "Platform engineering and user-centricity drive success, while AI begins to reshape the software delivery landscape." comment: This file is also hosted at https://services.google.com/fh/files/misc/dora_one_pager_2024.pdf update both together. allisonpark@ can update the PDF at services.google.com using go/gumdrop. --- diff --git a/hugo/content/research/2025/_index.md b/hugo/content/research/2025/_index.md index f159aa9a..f3dc3397 100644 --- a/hugo/content/research/2025/_index.md +++ b/hugo/content/research/2025/_index.md @@ -7,6 +7,7 @@ type: research_archives layout: single tab_order: "0" tab_title: "Overview" +archive_summary: "AI acts as an amplifier, but the greatest returns come from focusing on the underlying sociotechnical systems." --- diff --git a/hugo/themes/dora-2025/assets/scss/research.scss b/hugo/themes/dora-2025/assets/scss/research.scss index 7346c8c0..b7b2ebea 100644 --- a/hugo/themes/dora-2025/assets/scss/research.scss +++ b/hugo/themes/dora-2025/assets/scss/research.scss @@ -214,12 +214,30 @@ tab_links { &:hover { text-decoration: underline; } + + @media (min-width: 1000px) { + min-width: 16rem; + display: inline-block; // Ensure width is respected + } } .label { font-family: $font-google-sans; font-size: 1.1rem; font-weight: 500; + white-space: nowrap; // Prevent wrapping of label + } + + .archive-summary { + display: none; + flex: 1; + margin: 0 2rem; + color: $color-text-medium; + // font-family: $font-roboto; // Inherited + + @media (min-width: 1000px) { + display: block; + } } a.button { diff --git a/hugo/themes/dora-2025/layouts/partials/research_archives.html b/hugo/themes/dora-2025/layouts/partials/research_archives.html index dd5dc212..8b859198 100644 --- a/hugo/themes/dora-2025/layouts/partials/research_archives.html +++ b/hugo/themes/dora-2025/layouts/partials/research_archives.html @@ -1,57 +1,22 @@

Additional Publications