{"id":23940,"date":"2025-09-22T09:20:33","date_gmt":"2025-09-22T07:20:33","guid":{"rendered":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?p=23940"},"modified":"2025-09-22T12:15:16","modified_gmt":"2025-09-22T10:15:16","slug":"frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge","status":"publish","type":"post","link":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/","title":{"rendered":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t

Blog<\/h2>\n\t\t\t\t\t\t\t\t\t\t\t\t

iSAQB Software Architecture Gathering 2025\u200b<\/p>\n\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t<\/section>\n\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\"Photo\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Peter Hruschka<\/a><\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Principal of the Atlantic Systems Guild<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
Published on September 22, 2025<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge<\/h2>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
An interview with Peter Hruschka<\/h5>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

In anticipation of Peter Hruschka's keynote \"Framework Architectures\", Richard Wallintin (WPS - Workplace Solutions) asked him several questions about designing, documenting, and reusing frameworks effectively to improve software development practices.<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

What are the characteristics that make a \"good\" framework? (You'll probably mention documentation, but what else?)<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Frameworks (and libraries) are useful aids for developers to liberate them from (mostly technical) tasks. Therefore, a good framework should be easy to use and hard to misuse (similar to good interfaces). And yes: in order to make them easy to use, they should be well documented. For users of the framework, the documentation should cover everything a developer needs to know to properly integrate the framework into his\/her own systems. For the developer of a framework, the same rules apply as for any system: Have enough documentation that future enhancements can be developed without lots of reengineering efforts of the existing framework.\n\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Should frameworks be \"invented\" (from the drawing board) or \"harvested\" (extracted from concrete solutions)? If both, what is a healthy ratio?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Since most frameworks solve technical problems, I think they can be invented on the drawing board. Providing tools for building web applications, simplifying database interactions, helping to create user interfaces, or aiding in writing automated tests are well-understood topics.

\n\nHowever, if an organization develops multiple similar systems (or product families) in a specific domain, then there is a fair chance that domain-specific abstractions can be discovered and factored out into frameworks.

\n\nSo, I would guess the ratio between technical frameworks and domain-specific frameworks is likely to be 80:20.\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Would you generally encourage more people to harvest\/invent, publish, and promote new frameworks from their work, or is framework engineering an exceptional thing to do?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Coming back to the observations above, I would not encourage organizations to go into the (commercial) framework business. Marketing frameworks should be left to companies specializing in such products (or open-source projects).

\n\nBut every large IT organization should invest in discovering reusable ideas and factoring them out in form of frameworks and libraries \u2013 not with the intention to market them, but only to improve their inhouse effectiveness in product development instead of reinventing the wheel in every project.\n<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Is using standard\/established terminology a tool for tackling the abstractness of frameworks? arc42 is pretty widespread and brings some terminology with it. Are there other broadly accepted sources for well-understood general concepts?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

arc42 is a generic template for all kinds of applications (including frameworks). While chapter 5 of arc42 (i.e., the building block view) is of central importance for most applications, it is not so important for framework users. Chapter 8 (cross-cutting concepts) plays a more important role for framework users.

\n\nFinding and documenting such cross-cutting concepts is still an art and requires abstraction skills from the framework developers. We advocate that the documentation of such concepts should not only identify their key abstractions, but also include very practical information like examples, prototypes, runtime scenarios, test cases with source code, etc.<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Good documentation finds the right balance of textual & visual content, conceptual descriptions & very concrete instructions (and other tradeoffs). However, having access to an expert, interactive feedback, and active teaching are invaluable for adopting any technology (framework, library). What can framework authors do to cover this dimension?<\/b><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t
\n\t\t\t\t\t

Yes, correct. Having access to experts is definitely very helpful, instead of having documentation only. If no access is possible, the open-source initiative arc42 tries to help in many ways, especially with extensive published FAQS (faq.arc42.org), with lots of practical tips (docs.arc42.org).

\n\nSince developers learn best by copying from successful solutions, we also do publish complete system documentation about many different domains on Leanpub (https:\/\/leanpub.com\/bookstore?search=arc42%20by%20example&type=all).

\n\nA third volume on frameworks and libraries is in the pipeline, adding to the first two volumes (on commercial systems and embedded real-time systems).<\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t
More from the speaker<\/h6>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\n\t\t\t\t\t\t<\/span>\n\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t

Framework Architectures (Keynote by Peter Hruschka)<\/a><\/p>\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t

\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t\t\t\n\t\t\t\t<\/i>\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\tReturn to Overview<\/span>\n\t\t\t\t\t<\/span>\n\t\t\t\t\t<\/a>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\t<\/i>\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\n\t\t\t\t\t\t\t\"\"\t\t\t\t\t\t\t\t<\/a>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

Peter Hruschka explains how well-documented, reusable frameworks can streamline software development, balance abstraction with practical guidance, and improve in-house efficiency.<\/p>\n","protected":false},"author":201909760,"featured_media":23952,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1364],"tags":[1472,1725,1731,1719,1723,1726,1720,1728,1722,1729,1727,1732,1721,1435,1444,1730,1546,1724],"post_folder":[],"yoast_head":"\nFrameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge<\/title>\n<meta name=\"description\" content=\"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\" \/>\n<meta property=\"og:locale\" content=\"en_GB\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge\" \/>\n<meta property=\"og:description\" content=\"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\" \/>\n<meta property=\"og:site_name\" content=\"Software Architecture Gathering 2026\" \/>\n<meta property=\"article:published_time\" content=\"2025-09-22T07:20:33+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-22T10:15:16+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/conferences.isaqb.org\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Madlen Schenk\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:title\" content=\"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge\" \/>\n<meta name=\"twitter:description\" content=\"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Madlen Schenk\" \/>\n\t<meta name=\"twitter:label2\" content=\"Estimated reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\"},\"author\":{\"name\":\"Madlen Schenk\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1\"},\"headline\":\"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge\",\"datePublished\":\"2025-09-22T07:20:33+00:00\",\"dateModified\":\"2025-09-22T10:15:16+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\"},\"wordCount\":700,\"publisher\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg\",\"keywords\":[\"arc42\",\"best practices\",\"developer productivity\",\"documentation\",\"domain-specific frameworks\",\"framework engineering\",\"Frameworks\",\"interactive feedback\",\"knowledge sharing\",\"Leanpub\",\"library design\",\"Peter Hruschka\",\"reuse\",\"software architecture\",\"software development\",\"software patterns\",\"System Design\",\"technical frameworks\"],\"articleSection\":[\"Blog\"],\"inLanguage\":\"en-GB\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\",\"name\":\"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge\",\"isPartOf\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg\",\"datePublished\":\"2025-09-22T07:20:33+00:00\",\"dateModified\":\"2025-09-22T10:15:16+00:00\",\"description\":\"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.\",\"breadcrumb\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#breadcrumb\"},\"inLanguage\":\"en-GB\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg\",\"contentUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg\",\"width\":1200,\"height\":630},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\",\"name\":\"Software Architecture Gathering 2026\",\"description\":\"The Global Conference for Software Architecture\",\"publisher\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-GB\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization\",\"name\":\"Software Architecture Gathering 2026\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-GB\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png\",\"contentUrl\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png\",\"width\":500,\"height\":169,\"caption\":\"Software Architecture Gathering 2026\"},\"image\":{\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1\",\"name\":\"Madlen Schenk\",\"url\":\"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/author\/mschenkisaqb-org\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge","description":"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/","og_locale":"en_GB","og_type":"article","og_title":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge","og_description":"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.","og_url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/","og_site_name":"Software Architecture Gathering 2026","article_published_time":"2025-09-22T07:20:33+00:00","article_modified_time":"2025-09-22T10:15:16+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/conferences.isaqb.org\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg","type":"image\/jpeg"}],"author":"Madlen Schenk","twitter_card":"summary_large_image","twitter_title":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge","twitter_description":"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.","twitter_misc":{"Written by":"Madlen Schenk","Estimated reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#article","isPartOf":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/"},"author":{"name":"Madlen Schenk","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1"},"headline":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge","datePublished":"2025-09-22T07:20:33+00:00","dateModified":"2025-09-22T10:15:16+00:00","mainEntityOfPage":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/"},"wordCount":700,"publisher":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage"},"thumbnailUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg","keywords":["arc42","best practices","developer productivity","documentation","domain-specific frameworks","framework engineering","Frameworks","interactive feedback","knowledge sharing","Leanpub","library design","Peter Hruschka","reuse","software architecture","software development","software patterns","System Design","technical frameworks"],"articleSection":["Blog"],"inLanguage":"en-GB"},{"@type":"WebPage","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/","name":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge","isPartOf":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website"},"primaryImageOfPage":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage"},"thumbnailUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg","datePublished":"2025-09-22T07:20:33+00:00","dateModified":"2025-09-22T10:15:16+00:00","description":"Learn from Peter Hruschka how to design, document, and reuse frameworks effectively to boost software development efficiency and share knowledge across teams.","breadcrumb":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#breadcrumb"},"inLanguage":"en-GB","potentialAction":[{"@type":"ReadAction","target":["https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/"]}]},{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#primaryimage","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg","contentUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2025\/09\/SAG-2025-Interview-Hruschka-FB-d1.jpg","width":1200,"height":630},{"@type":"BreadcrumbList","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/frameworks-done-right-peter-hruschka-on-documentation-reuse-and-sharing-knowledge\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/"},{"@type":"ListItem","position":2,"name":"Frameworks Done Right: Peter Hruschka on Documentation, Reuse, and Sharing Knowledge"}]},{"@type":"WebSite","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#website","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/","name":"Software Architecture Gathering 2026","description":"The Global Conference for Software Architecture","publisher":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-GB"},{"@type":"Organization","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#organization","name":"Software Architecture Gathering 2026","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/","logo":{"@type":"ImageObject","inLanguage":"en-GB","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png","contentUrl":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-content\/uploads\/2024\/02\/SAG-Logo-2024-rgb-500x170-transparent.png","width":500,"height":169,"caption":"Software Architecture Gathering 2026"},"image":{"@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/#\/schema\/person\/6e1a84159b2d354efc741d2fbc8c3eb1","name":"Madlen Schenk","url":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/author\/mschenkisaqb-org\/"}]}},"_links":{"self":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23940"}],"collection":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/users\/201909760"}],"replies":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/comments?post=23940"}],"version-history":[{"count":9,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23940\/revisions"}],"predecessor-version":[{"id":23951,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/posts\/23940\/revisions\/23951"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/media\/23952"}],"wp:attachment":[{"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/media?parent=23940"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/categories?post=23940"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/tags?post=23940"},{"taxonomy":"post_folder","embeddable":true,"href":"https:\/\/conferences.isaqb.org\/software-architecture-gathering\/wp-json\/wp\/v2\/post_folder?post=23940"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}