Communicating Drupal: Documentation and Discovery
Jeff Traynor
7/15/14
Prepared For: DrupalCamp LA 2014
Solutions Architect
Achieve’s Footprint
What would you say you do here?
Architecture
In De Architectura, Marcus Vitruvius Pollio describes three
fundamental principles which great architecture should accomplish:
• Firmatis: It should stand up robustly and remain in good condition
— it should be durable.
• Utilitas: It should be useful and function well for the people using it
— it should be functional.
• Venustatis: It should delight people and raise their spirits — it should be beautiful.
Achieve at a GlanceLongevity
Scale
Physics
Environment
Cost of Construction
Documentation Matters
Documentation is a source of clarity • “If you can’t explain it to a six year old, you don’t understand it
yourself” – Albert Einstein
Documentation is a mechanism for accountability • Managing budgets, scope, an expectations• Advocating for project stakeholders
Documentation is a site of collaboration • Documenting process and collaborative creation• Recording the decision making process
!
Feasibility Study
Business Requirements
Why?
Business Requirements
Customer ProfileStrategic Initiative Problem Analysis
Goals & Objectives Target Audience
Stakeholders Project Team
Timeline & Milestones
Business Requirements
Who?
User Personas
Schematic Design
Information Architecture
Where?
Information Architecture
!Documents Produced:
• Sitemap Diagrams• User Flow Diagrams• Systems Integration Diagrams
Design Development
Prototyping
What?
Prototyping
Construction Documents
Functional Requirements
How?
Functional Requirements
Functional Requirements
Features Content Types
Taxonomies Views
Modules Workflows
Integrations
Functional Requirements
Proprietary Specifications vs
Performance Specifications
Contract Administration
Architecture & Planning
!Documents Produced:
• Epics & User Stories• DevOps Plan• Development Plan• Sprint Plan and Milestones
•
Thank You
it’s not magic, it’s excellence.
Jeff Traynor Solutions Architect
[email protected] @jtray