Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Principle: Continuously maintain and evolve #505

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 38 additions & 0 deletions docs/principles/continuously-maintain-and-evolve.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
layout: principle
order: 1
title: Continuously maintain and evolve
date: 2025-01-17
tags:
- Ways of working
- Infrastructure
- Dependencies
- Security
- SRE
related:
sections:
- title: Related links
items:
- text: Write maintainable, reusable and evolutionary code
href: /principles/write-maintainable-reusable-and-evolutionary-code/
- text: Well managed code
href: /principles/well-managed-code/
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could add this video as a related link: https://www.youtube.com/watch?v=jjFgyAOIhSg

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or could incorporate points from the video

---

Building great products isn't just about writing good code initially - it's about continuously maintaining and evolving them. Regularly update codebases, dependencies, pipelines, infrastructure, and processes to ensure they remain secure, performant, and aligned with current standards. Avoid allowing systems to stagnate by scheduling maintenance and improvements as a regular part of the delivery lifecycle.

---

## Rationale

Outdated systems are harder to support and integrate with modern components, leading to increased technical debt over time. Regular updates are essential to reduce exposure to known vulnerabilities, enhancing the security of the system. Keeping tools and libraries up to date also sustains efficiency by leveraging improved performance and new features. Neglecting regular maintenance often results in costly big bang upgrades, making continuous updates a more cost-effective approach.

---

## Applications and Implications

- Schedule time dedicated to updating dependencies, refactoring code, and maintaining pipelines. This proactive approach ensures that systems remain current and reduces the risk of accumulating technical debt
- Continuously observe and assess updates in the technology ecosystem, such as new library versions or framework releases. Staying informed enables timely adoption of improvements and ensures compatibility with external systems
- Regularly review the [Home Office Engineering Guidance and Standards](/) to ensure that products remaining aligned with standards and best practices
- Automatically detect outdated dependencies and facilitate testing processes. Automation streamlines maintenance tasks, minimises human error, and accelerates the integration of necessary updates
- Incorporate planned and measurable maintenance activities into team roadmaps. By formally recognising maintenance as a critical component of the development lifecycle, teams can allocate resources effectively and maintain system integrity over time
dk4g marked this conversation as resolved.
Show resolved Hide resolved