Jump to: navigation, search

Architecture Design Guide work items

Revision as of 23:38, 17 December 2015 by Darren Chan (talk | contribs)

Architecture Design Guide Reorganization

  1. Do not modify the current guide in openstack-manuals/docs/arch-design. A draft directory has been set up in openstack-manuals/docs/arch-design-draft.
  2. Please ensure your commit messages references the blueprint: Implements: blueprint arch-guide-mitaka-reorg
  3. To avoid merge conflicts, work in a different section to someone else.

Resources

[ https://etherpad.openstack.org/p/arch-guide-reorg etherpad] [ spec ]

Global changes

To assign yourself a task, put your name next to the task and reference the review URL. Change the status to complete when the task is completed.

  1. markup glossary terms


Chapter/Section

To assign yourself a task, put your name next to the task and reference the review URL. Change the status to complete when the task is completed.

Chapter 1. Introduction

1.1 Intended audience

  1. include content from the original guide

1.2 How this book is organized

  1. Rewrite this section mentioning the book follows a structure that system architects would use in developing cloud architecture design documents

1.3 Why and How we wrote this book


Chapter 2 Identifying stakeholders

  1. Describe who the internal and external stakeholders are, and the impact they may have on business requirements and architecture design.

Chapter 3 Functional Requirements

Chapter 4 User requirements

Chapter 5 Operator requirements

5.1 SLA considerations 5.2 Monitoring 5.3 Selecting hardware Selecting the right hardware - servers, switches, and how they integrate

5.4 integration with external IDP


Chapter 8. Security requirements

  1. include original content. Perhaps reference to the relevant sections in the Security Guide?


Chapter 9. Legal requirements

  1. include original content. Is it possible to include examples or things to consider?

Chapter 10. Example architectures

(reflecting concepts and terminology described in previous chapters) 10.1 Small scale, single site with Neutron networking 10.2 Adding another region 10.3 Scaling with multiple cells