Scaling Documentation and Team Practices Ahmad Nassri - Principal Architect, TELUS digital 

About Ahmad 

Ahmad Nassri Syrian-Canadian, Entrepreneur, Hacker, Developer, Open Source Advocate & Dog Lover. Principal Architect at TELUS digital, Founder at Bench CI, Founder at Tech Masters, Mentor at NodeSchool Toronto, Board Member at Full Stack Toronto, Organizer at Functions Conf, NodeDay Toronto, Editor at The RESTful Web. 

About TELUS 

Phone Internet Mobile TV 

Home Security Health IoT 

No content

No content

Traditional Enterprise IT 

No content

About TELUS digital 

Our Mission Enable customers and team members to do what they want to do, easily Our Principles… • Focus on Customer First • Value data over opinions • Deliver outcomes over outputs • Take risks and be lean • Be an owner • Build for quality and reuse • Attract and develop leaders • Embrace inclusivity • Strengthen communities around us 

Humble Beginnings • First solid attempt at digital transformation: My Account • Enable customers to check their bills, usage, call history, etc... • Our first Agile/Scrum, Cloud, DevOps & IaaS project • Mobile-first experience, delivered just in time for the smartphone explosion • Highly accessible site; WCAG 2AA compliant • Highest customer satisfaction of the big 3 Canadian Telcos 

CONSUMER BUSINESS MY ACCOUNT RUBY ON RAILS ENGINE YARD AWS (PaaS) TELUS DIGITAL AWS CMS (COMFY) PHP ON CODEIGNITER (PRIME) PHP ON CODEIGNITER (PRIME) BTO SERVICE CMS (LIGER) BTO SERVICE TELUS DIGITAL AWS BTO SERVICE JAVA CMS HS (LIGER) CMS (WMD) TELUS DIGITAL AWS TELUS DIGITAL AWS PHP ON CODEIGNITER (PRIME) COMMERCE (DRUPAL) BTO SERVICE ... CMS (WMD) FROGGER | HYDRA | JSP FROGGER | TWIGGY ANGULAR | REACT BUSINESS CSS | HAML FROGGER | TWIGGY | ANGULAR RUBY ON SINATRA TELUS DIGITAL AWS VUE BTO SERVICE ... TELUS DIGITAL AWS NODEJS CMS (CONTENTFUL) THORIUM | REACT TELUS DIGITAL AWS JAVA ON SPRING BOOT THORIUM | VUE BTO SERVICE ... ● Team grew quickly ● Moved quickly ● Operating model evolved without strong architectural oversight ● Many disparate technical stacks ● What made us successful to date isn't what will work at scale 2015 - 2016: Growth 

Onboarding Failure 

● Multiple tech stacks ● Multiple overlapping CSS files ● No single source of code or design truth ● Teams reinvent the wheel ● Inconsistent customer experience ● Builds and updates take longer Growing Pains Many teams are building TELUS experiences without an easy way to reuse work, share ideas, or receive and consume design / code updates. 

Circles of Influence & Community of Practice Digital Koodo Public Mobile Int. Health IT Partners 

Land of broken toys • Disjointed customer experience • Very complicated technical landscape • Large effort required to deliver quality experiences Which leads to … • Unhappy Developers • Unhappy Customers • Unhappy Business 

Digital Architecture - 2017 INFRASTRUCTURE (Amazon Web Services) DESIGN SYSTEM (React) WEB (React, Redux) NATIVE (iOS, Android) API (Node.js / Express) MONITOR (Kibana) SCALE (Kubernetes) DEPLOY (OpenShift) BUILD (Docker) PIPELINE (Jenkins) DEVELOPMENT DELIVERY ANALYTICS (Adobe Analytics) TRACKING (Adobe DTM) DMP (Adobe AEM) PERSONALIZATION (Adobe Target) DATA LAKE (Hadoop / Cassandra) INSIGHTS AI (TensorFlow) ACCESSIBILITY (aXe) END-2-END (Nightwatch) FUNCTIONAL (Jest) SECURITY (Contrast, NSP) PERFORMANCE (Artillery) TESTING SEGMENTATION (Adobe Audience Manager) A/B TEST (Adobe Target) ORCHESTRATION (GraphQL) SEO (Lighthouse) CONTENT (Contentful) 

Big Bang 2.0 Culture of Enablement 

“Culture eats strategy for breakfast, lunch and dinner” - Peter Drucker Main Guiding Principle: 

A more systematic approach to development and design will enable us to build at scale, leverage the collective wisdom of our teams and partners, and more easily deliver consistently great experiences to customers. 

path to production Assess your value chain and kick-start your culture of architecture by mapping your path to production. 

STRATEGY, DESIGN & TECH PORTFOLIO & INSIGHTS OPERATIONS (accessibility, security, ops) PEOPLE OPS OUTCOME TEAMS ENABLEMENT TEAMS MOBILITY BUSINESS MY ACCOUNT HOME SOLUTIONS 

Improving our Practices: #MeetingMondays Why: Respect Maker Time! We’ve observed so many meeting taking place throughout the week, leaving little time for makers to focus on their work. What: An evolution of our habits, a consolidation of our Design, Content, Development, PO, Architecture, and Platform specific meetings into one full day of activities How: • Showcases: share updates, Q&A, collect feedback • Architecture Forum: Introduce new standards or improve existing ones • Breakout Sessions, Deep Dives: ○ Increase collaboration ○ Encourage culture of sharing • Guest Speakers (internal & external): ○ Increase expertise in key areas (SEO, Content Strategy, Design, Marketing, etc...) ○ Visibility into key lines of business 

No content

• Hosted on Github • Open for Everyone • Issues and Comments as tools for Collaborative Discussion • Historical & Decision Record • Design, Tech, Process & Strategy Architecture Forum 

Improving our Practices: Training & Workshops Workshops: ● Platform Product Tours across Montreal, Toronto, and Vancouver ● Design Training ● Analytics and Data Training ● Hackathons Self Directed Courses (Video): ● API Platform: API Gateway 101 ● Design Platform: Invision + Sketch Training ● Device Farm 101 ● Automated Testing 101 ● Delivery 101 

Improving our Practices: Slack Channels Primary: Digital Platform: #t-digital-platform Digital Services: #t-digital-services Secondary: Content Platform: #g-content-platform API Platform: #g-api-practice Testing Platform: #g-testing TELUS Design System: #tds-guild Global Elements: #s-global-elements Delivery Platform: #g-delivery Analytics Platform: #g-personalization 

No content

No content

Reference Architecture ● Open Contribution Model ● Design Standards ● Development Standards ● Accessibility Standards ● Security Standards ● Process Standards ● Testing Standards ● Delivery Standards ● Performance Standards 

Friendly and Open Contribution Model • No Ivory Towers! • No Sacred Cows! • Everybody can contribute (including non-makers) • Design, Tech, Process, Strategy & more! • Introduce New Ideas • Evolve Existing Standard • Dedicated Time to discuss • Experiment, Build, Measure, Repeat 

Focus on Knowledge Sharing → Always Start with “Why” → Provide Context & Evidence → Least important part is the “How” → Use the Architecture Forum to discuss → Use #MeetingMondays to Build 

Codify Standards into Starter Kits ● TELUS Isomorphic Starter Kit ● Koodo Isomorphic Starter Kit ● API Starter Kit ● Node Starter Kit ● Ruby Starter Kit ● Java Starter Kit ● Spring Boot Starter Kit ● Starter Kit - Starter Kit! 

• Full End to End Testing ○ (unit, functional, integration, seo, security, performance, accessibility, analytics, ...) • Automated Deployments • High Threshold gating (we don’t compromise on quality) Codify Standards into Automated Pipelines 

TELUS digital Products, Practices, Standards, Code and Governance to enable our teams at scale More than just Practices Standards Products Practices Governance ● High Reusability ● Build or Buy ● No Sacred Cows ● Detailed Roadmaps ● Visible Catalogues ● Enablement Tools ● Collaborative model ● Agile Workflow ● Documentation ● Education ● Guild meetings ● Slack channels ● Standards ● Change management ● Acceptance criteria ● Contribution model 

1 Onboard 2 Design 3 Code 4 Updates USE 5 Feedback 6 Design 7 Code CONTRIBUTE Contribution Framework 

We do all of this in public to truly embrace our customer first commitment github.com/telusdigital/reference-architecture 

Keeping a Strong Momentum 

What’s Next? The Future is Friendly 

Thank you! @AhmadNassri ahmad.codes/talks 

No content