Scaling Documentation and Team Practices

Presented at Github Constellation Toronto 2018

https://githubconstellation.com/toronto/

Transcript

1. TORONTO Scaling Documentation and Team Practices Ahmad Nassri - Principal Architect, TELUS digital
2. Scaling Documentation and Team Practices Ahmad Nassri - Principal Architect, TELUS digital
3. About Ahmad
4. 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.
5. tl;dr http://ahmad.codes
6. About TELUS
7. Phone Internet Mobile TV
8. Home Security Health IoT
11. Traditional Enterprise IT
13. About TELUS digital
14. 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
15. 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
16. 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
17. Onboarding Failure
18. • 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.
19. 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
20. Circles of Influence & Community of Practice
21. Digital Architecture - 2017 - 2018 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)
22. Big Bang 2.0 Culture of Enablement
23. “Culture eats strategy for breakfast, lunch and dinner” - Peter Drucker Main Guiding Principle:
24. 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.
25. Today, every company is becoming a software company and developers are at the center of digital transformation; they drive business processes and functions across organizations from customer service and HR to marketing and IT. And the choices these developers make will increasingly determine value creation and growth across every industry. Satya Nadella, Microsoft CEO
26. Improving our Practices: #MeetingMondays 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 Why: Respect Maker Time! We’ve observed so many meetings 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
28. • Hosted on Github • Open for Everyone • Issues and Comments as tools for Collaborative Discussion • Historical & Decision Record • Design, Tech, Process & Strategy Architecture Forum
29. 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
30. 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
33. Reference Architecture • Open Contribution Model • Design Standards • Development Standards • Accessibility Standards • Security Standards • Process Standards • Testing Standards • Delivery Standards • Performance Standards
34. 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
35. 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
36. 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!
37. • 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
38. 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
39. 1 Onboard 2 Design 3 Code 4 Updates USE 5 Feedback 6 Design 7 Code CONTRIBUTE Contribution Framework
40. We do all of this in public to truly embrace our customer first commitment github.com/telus/reference-architecture
41. tl;dr
42. What’s Next? The Future is Friendly
43. Thank you! telus.com/digital @AhmadNassri ahmad.codes/talks