liveBook · Manning

Maintainability

As explained in The Well-Grounded Python Developer: How the pros use Python and Flask

Maintainability is the degree to which software can be understood, modified, corrected, and extended efficiently.

Maintainability is the degree to which software can be understood, modified, corrected, and extended efficiently. It matters because requirements change, and code is read more often than it is written. section 1.3.2

Readable, maintainable code uses consistent conventions, meaningful names, and comments that clarify intent. These habits help both future maintainers and developers returning to their own work. section 1.3.2

Separate calculation from presentation

A function that calculates a result, formats it, and prints it is difficult to reuse. Refactoring separates calculation from formatting and output, leaving each function more flexible. section 1.3.2

Maintainability connects local coding choices to larger application development: developers build modules for larger applications and treat maintainability as a continuing strength. section 1.0 section 7.6

How The Well-Grounded Python Developer: How the pros use Python and Flask covers it

How deep it goes
Explains conventions, naming, comments, flexibility, and function separation through a worked refactoring, without detailing testing or deployment.
Examples
Uses a calculation-formatting-output function example and a MyBlog application configuration improvement.
What you can do after
Apply coding conventions and refactor coupled functions into clearer, more reusable components.
How it connects
Connects coding conventions, naming, comments, refactoring, modularity, and application architecture.

Also explained in

Compare how 7 books explain maintainability →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of The Well-Grounded Python Developer: How the pros use Python and Flask. The section links point to the parts of the book it draws on.