References and Sources
This section provides a comprehensive list of all sources and references cited throughout the book, compiled in alphabetical order for ease of reference. Each entry includes information about which chapters reference the source.
Numbered source index
- [Source [1]:]{#source-1} Thoughtworks. Architecture as Code: The Next Evolution. Technology Radar, 2024. Referenced in: Chapter 01: Introduction to Architecture as Code, Chapter 02: Fundamental Principles of Architecture as Code, Chapter 04: Architecture Decision Records, Chapter 05: Automation, DevOps and CI/CD, Chapter 26A, Chapter 32.
- [Source [2]:]{#source-2} Thoughtworks Technology Radar. Governance as Code. Thoughtworks Technology Radar Vol. 21, November 2019. Available at: https://www.thoughtworks.com/about-us/news/2019/technology-radar-edition21 [blip introduced Vol. 21; archived from techniques listing]. Referenced in: Chapter 03: Version Control and Code Structure, Chapter 08: Microservices Architecture as Code, Chapter 11: Governance as Code, Chapter 23: Software as Code Interplay, Chapter 26A.
- [Source [3]:]{#source-3} Atlassian. Git Workflows for Architecture as Code. Atlassian Git Documentation, 2024. Available at: https://www.atlassian.com/git/tutorials/comparing-workflows. Referenced in: Chapter 02: Fundamental Principles of Architecture as Code, Chapter 03: Version Control and Code Structure.
- [Source [4]:]{#source-4} GitHub Docs. About protected branches. GitHub Documentation, 2024. Available at: https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches. Referenced in: Chapter 02: Fundamental Principles of Architecture as Code, Chapter 03: Version Control and Code Structure, Chapter 11: Governance as Code, Chapter 14: Practical Implementation, Chapter 20, Chapter 23: Software as Code Interplay.
- [Source [5]:]{#source-5} HashiCorp. What is Terraform. HashiCorp Developer Documentation, 2024. Available at: https://developer.hashicorp.com/terraform/intro. Referenced in: Chapter 05: Automation, DevOps and CI/CD, Chapter 07: Containerisation and Orchestration as Code.
- [Source [6]:]{#source-6} Cloud Native Computing Foundation. Cloud Native Definition. CNCF GitHub, 2024. https://github.com/cncf/toc/blob/main/DEFINITION.md. Referenced in: Chapter 07: Containerisation and Orchestration as Code, Chapter 08: Microservices Architecture as Code.
- [Source [7]:]{#source-7} Cloud Native Computing Foundation. State of Cloud Native Development 2024. Cloud Native Computing Foundation, 2024. Referenced in: Chapter 01: Introduction to Architecture as Code, Chapter 7: Containerisation and Orchestration as Code, Chapter 08: Microservices Architecture as Code, Chapter 26A.
- [Source [8]:]{#source-8} Beyer, B. et al. (Google LLC). The Site Reliability Workbook: Practical Ways to Implement SRE. O'Reilly Media, 2018. ISBN: 978-1-4920-2974-8. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [9]:]{#source-9} AWS. AWS Cloud Development Kit (CDK) Developer Guide. Amazon Web Services, 2024. Available at: https://docs.aws.amazon.com/cdk/v2/guide/home.html. Referenced in: Chapter 03: Version Control and Code Structure, Chapter 05: Automation, DevOps and CI/CD, Chapter 07: Containerisation and Orchestration as Code, Chapter 14: Practical Implementation.
- [Source [10]:]{#source-10} Open Policy Agent. Policy as Code Overview. CNCF OPA Project, 2024. https://www.openpolicyagent.org/docs. Referenced in: Chapter 02: Fundamental Principles, Chapter 08: Microservices Architecture as Code, Chapter 10, Chapter 11: Governance as Code, Chapter 13: Testing Strategies, Chapter 22: Documentation as Code vs Architecture as Code, Chapter 23: Software as Code Interplay, Chapter 32.
- [Source [11]:]{#source-11} NIST. Security and Privacy Controls for Information Systems and Organisations. NIST Special Publication 800-53, Revision 5, 2020. Referenced in: Chapter 09: Security Fundamentals for Architecture as Code, Chapter 11: Governance as Code, Chapter 12: Compliance and Regulatory Adherence.
- [Source [12]:]{#source-12} Microsoft Learn. Design multi-stage release pipelines with approvals. Microsoft Learn Documentation, 2024. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [13]:]{#source-13} Kubernetes. Kubernetes Documentation: Concepts. Kubernetes Project, 2024. https://kubernetes.io/docs/concepts/. Referenced in: Chapter 05: Automation, DevOps and CI/CD, Chapter 07: Containerisation and Orchestration as Code, Chapter 13: Testing Strategies.
- [Source [14]:]{#source-14} ISO/IEC. ISO/IEC 27001:2022 Information Security Management. International Organisation for Standardisation, 2022. Referenced in: Chapter 12: Compliance and Regulatory Adherence, Chapter 15A: Evidence as Code and Continuous Assurance.
- [Source [15]:]{#source-15} Pulumi. Testing Infrastructure as Code Programs. Pulumi Blog, 2024. Referenced in: Chapter 13: Testing Strategies for Infrastructure as Code.
- [Source [16]:]{#source-16} HashiCorp. Securing Terraform State. HashiCorp Developer Documentation, 2024. Available at: https://developer.hashicorp.com/terraform/language/state/sensitive-data. Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Advanced Security Patterns and Implementation.
- [Source [17]:]{#source-17} HashiCorp. Backend Type: s3. HashiCorp Developer Documentation, 2024. Available at: https://developer.hashicorp.com/terraform/language/backend/s3. Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Advanced Security Patterns and Implementation.
- [Source [18]:]{#source-18} Microsoft Learn. Store Terraform state in Azure Storage. Microsoft Learn Documentation, 2024. Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Advanced Security Patterns and Implementation.
- [Source [19]:]{#source-19} Google Cloud. Store Terraform state in Cloud Storage. Google Cloud Documentation, 2024. Available at: https://cloud.google.com/docs/terraform/resource-management/store-state. Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Advanced Security Patterns and Implementation.
- [Source [20]:]{#source-20} HashiCorp. Terraform Security Best Practices. HashiCorp Learning Resources, 2023. Available at: https://developer.hashicorp.com/terraform/cloud-docs/recommended-practices. Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Advanced Security Patterns and Implementation.
- [Source [21]:]{#source-21} Write the Docs. Docs as Code. Write the Docs Community, 2024. Available at: https://www.writethedocs.org/guide/docs-as-code/. Referenced in: Chapter 02: Fundamental Principles of Architecture as Code.
- [Source [22]:]{#source-22} Jenkins. Pipeline Overview. Jenkins Documentation, 2024. Available at: https://www.jenkins.io/doc/book/pipeline/. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [23]:]{#source-23} GitHub. Understanding GitHub Actions. GitHub Documentation, 2024. Available at: https://docs.github.com/en/actions. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [24]:]{#source-24} Microsoft. What is Azure Pipelines? Microsoft Learn, 2024. Available at: https://learn.microsoft.com/en-us/azure/devops/pipelines/get-started/what-is-azure-pipelines. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [25]:]{#source-25} GitLab. Get started with GitLab CI/CD. GitLab Documentation, 2024. Available at: https://docs.gitlab.com/ee/ci/. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [26]:]{#source-26} HashiCorp. Write Terraform Tests. HashiCorp Developer Documentation, 2024. Available at: https://developer.hashicorp.com/terraform/language/tests. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [27]:]{#source-27} GDPR.eu. GDPR for Organisations: Practical Guide. GDPR.eu, 2024. Available at: https://gdpr.eu/for-organizations/. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [28]:]{#source-28} DORA. Accelerate State of DevOps Report 2023. Google Cloud / DORA, 2023. Available at: https://dora.dev/research/2023/dora-report/. Referenced in: Chapter 05: Automation, DevOps and CI/CD.
- [Source [29]:]{#source-29} Red Hat. Architecture as Code Principles and Best Practices. Red Hat Developer, 2023. Available at: https://www.redhat.com/en/topics/devops/what-is-infrastructure-as-code. Referenced in: Chapter 01: Introduction to Architecture as Code, Chapter 02: Fundamental Principles of Architecture as Code.
- [Source [30]:]{#source-30} Skelton, M. & Pais, M. Team Topologies: Organising Business and Technology Teams for Fast Flow. IT Revolution Press, 2019. ISBN: 978-1-942788-81-4. Referenced in: Chapter 17: Organisational Change, Chapter 18: Team Structure, Chapter 27: Conclusion.
- [Source [31]:]{#source-31} Forsgren, N., Humble, J. & Kim, G. Accelerate: The Science of Lean Software and DevOps. IT Revolution Press, 2018. ISBN: 978-1-942788-33-1. Referenced in: Chapter 17: Organisational Change, Chapter 19: Management as Code, Chapter 27: Conclusion.
- [Source [32]:]{#source-32} Bass, L., Clements, P. & Kazman, R. Software Architecture in Practice (4th ed.). Addison-Wesley, 2021. ISBN: 978-0-13-688580-4. Referenced in: Chapter 27: Conclusion.
Academic and Industry Publications
AaC Open Source Project. "Architecture-as-Code Repository." https://github.com/finos/architecture-as-code Referenced in: Chapter 6: Structurizr and Diagram Automation, Appendix B: Technical Architecture for Book Production
Architecture Decision Records Community. "ADR Guidelines and Templates." https://adr.github.io Referenced in: Chapter 4: Architecture Decision Records
Write the Docs. "Docs as Code." Write the Docs Community, 2024. See numbered index: Source [21] Referenced in: Chapter 2: Fundamental Principles
Brown, S. "C4 Model Overview." https://c4model.com/ Referenced in: Chapter 6: Structurizr and Diagram Automation, Chapter 24: Best Practices
Brown, S. "Documenting Software Architecture with Structurizr." Structurizr Blog, 2022. Referenced in: Chapter 6: Structurizr and Diagram Automation, Chapter 24: Best Practices
Brown, S. "Software Architecture for Developers." Leanpub, 2022 (continuously updated). Available at: https://leanpub.com/software-architecture-for-developers (digital-only publication, no ISBN). Referenced in: Chapter 6: Structurizr and Diagram Automation
Chung, L., Nixon, B.A., Yu, E. & Mylopoulos, J. "Non-Functional Requirements in Software Engineering." Springer, 2000. ISBN: 978-0-7923-8666-6 Referenced in: Chapter 2: Fundamental Principles
Cloud Native Computing Foundation. "State of Cloud Native Development 2024." Cloud Native Computing Foundation, 2024. See numbered index: Source [7] Referenced in: Chapter 1: Introduction, Chapter 7: Containerisation
FINOS. "CALM: Common Architecture Language Model." FINOS Architecture as Code Community, 2024. https://calm.finos.org/ Referenced in: Chapter 22: Documentation as Code vs Architecture as Code
Ford, N., Parsons, R. & Kua, P. "Building Evolutionary Architectures: Support Constant Change." 1st ed. O'Reilly Media, 2017. ISBN: 978-1-491-98634-9 Referenced in: Chapter 22: Documentation as Code vs Architecture as Code
Forsberg, K., Mooz, H. "The Relationship of System Engineering to the Project Cycle." Engineering Management Journal, 1991. Referenced in: Chapter 2: Fundamental Principles
GitLab. "Documentation as Code: Best Practices and Implementation." GitLab Documentation, 2024. Referenced in: Chapter 2: Fundamental Principles
GitLab. "Building a Single Source of Truth with APIs and CLI." GitLab Topics, 2024. Referenced in: Chapter 2: Fundamental Principles, Chapter 11: Governance as Code
GitHub Docs. "About protected branches." See numbered index: Source [4] Referenced in: Chapter 03: Version Control and Code Structure, Chapter 11: Governance as Code, Chapter 14: Practical Implementation, Chapter 23: Software as Code Interplay
GitHub Open Source Community. "Collaborative Software Development." Platform Documentation, 2024. Referenced in: About the Author
IEEE. "IEEE Standard for Software Verification and Validation." IEEE Std 1012-2016, 2017. Referenced in: Chapter 2: Fundamental Principles
HashiCorp. "Policy as Code Overview." https://developer.hashicorp.com/terraform/cloud-docs/policy-enforcement Referenced in: Chapter 23: Software as Code Interplay
Kvadrat AB. "Gunnar Nordqvist - Chief Architect Profile." Consultant Profile, 2024. Available at: https://www.kvadrat.se/anlita-kvadrat/hitta-konsult/gunnar-nordqvist/ Referenced in: About the Author
Kvadrat AB. "Technology Consulting Excellence." Company Profile, 2024. Available at: https://www.kvadrat.se/ Referenced in: About the Author
MarketsandMarkets. "Infrastructure as Code Market Report." MarketsandMarkets, 2023. Referenced in: Chapter 15: Cost Optimisation, Chapter 25: Future Trends Development
Martin, R.C. "Clean Architecture: A Craftsman's Guide to Software Structure and Design." Prentice Hall, 2017. ISBN: 978-0-13-468599-1 Referenced in: Chapter 1: Introduction, Chapter 2: Fundamental Principles
Mermaid. "Mermaid: Diagramming and Charting Tool." Mermaid Documentation, 2024. https://mermaid.js.org/ Referenced in: Chapter 22: Documentation as Code vs Architecture as Code
NIST. "Requirements Engineering for Secure Systems." NIST Special Publication 800-160, 2023. Referenced in: Chapter 2: Fundamental Principles
Nygard, M. "Documenting Architecture Decisions." 2011. Referenced in: Chapter 4: Architecture Decision Records
Open Policy Agent. "Policy as Code Overview." See numbered index: Source [10] Referenced in: Chapter 2: Fundamental Principles, Chapter 11: Governance as Code, Chapter 23: Software as Code Interplay
OMG. "Model Driven Architecture (MDA)." Object Management Group White Paper, 2001. Referenced in: Chapter 2: Fundamental Principles
PlantUML. "PlantUML: Open-source Tool for Creating UML Diagrams." PlantUML Documentation, 2024. https://plantuml.com/ Referenced in: Chapter 22: Documentation as Code vs Architecture as Code
Red Hat. "Architecture as Code Principles and Best Practices." Red Hat Developer, 2023. See numbered index: Source [29] Referenced in: Chapter 1: Introduction, Chapter 2: Fundamental Principles
Richardson, C. "Microservices Patterns: With Examples in Java." Manning Publications, 2018. ISBN: 978-1-617-29454-1 Referenced in: Chapter 22: Documentation as Code vs Architecture as Code
Schmidt, D. C. "Model-Driven Engineering." IEEE Computer, 2006. Referenced in: Chapter 2: Fundamental Principles
Selic, B. "The Pragmatics of Model-Driven Development." IEEE Software, 2003. Referenced in: Chapter 2: Fundamental Principles, Chapter 6: Structurizr and Diagram Automation, Chapter 23: Software as Code Interplay
Structurizr. "Structurizr DSL Language Reference." Structurizr Documentation, 2024. https://github.com/structurizr/dsl Referenced in: Chapter 6: Structurizr and Diagram Automation, Chapter 22: Documentation as Code vs Architecture as Code
Structurizr. "Structurizr Lite." Structurizr Documentation, 2024. https://docs.structurizr.com/lite Referenced in: Chapter 6: Structurizr and Diagram Automation
Thoughtworks Technology Radar. "Diagrams as Code." https://www.thoughtworks.com/radar/techniques/diagrams-as-code Referenced in: Chapter 6: Structurizr and Diagram Automation
Thoughtworks. "Architecture as Code: The Next Evolution." Technology Radar, 2024. See numbered index: Source [1] Referenced in: Chapter 1: Introduction, Chapter 2: Fundamental Principles, Chapter 4: Architecture Decision Records
Thoughtworks. "Architecture Decision Records." Technology Radar, 2023. Referenced in: Chapter 4: Architecture Decision Records
Thoughtworks Technology Radar. "Governance as Code." Technology Radar Vol. 21, November 2019. See numbered index: Source [2] Referenced in: Chapter 11: Governance as Code
Industry Research and Reports
Nordqvist, G. Architecture as Code: practitioner experience from enterprise architecture and platform engineering engagements, 2019–2024. Author's own professional practice. Available on request via the book repository.
Gartner. "Forecast Analysis: Public Cloud Services Worldwide." Gartner Research, 2024. Referenced in: Chapter 15: Cost Optimisation, Chapter 17: Organisational Change
IDC. "Worldwide DevOps Software Tools Forecast, 2023–2027." IDC Research, 2023. Referenced in: Chapter 5: Automation, DevOps, and CI/CD, Chapter 21: Digitalisation
HashiCorp. "State of Cloud Strategy Survey 2024." HashiCorp, 2024. Referenced in: Chapter 17: Organisational Change, Chapter 27: Conclusion
Microsoft Learn. "Store Terraform state in Azure Storage." Microsoft Learn Documentation, 2024. See numbered index: Source [18] Referenced in: Chapter 9: Security Fundamentals for Architecture as Code, Chapter 9b: Security Patterns and Implementation
Using This References Section
This comprehensive list ensures traceability between the book's content and its sources. When reading a chapter:
- Check the chapter's "Sources" section for immediate context
- Refer to this comprehensive list for full bibliographic details
- Use the cross-references to find related discussions across chapters
All citations in the manuscript are included in this compiled list, ensuring complete transparency and academic rigour throughout the work.