Wednesday Playbook
Our Services
  • Welcome to our Playbook
  • What we do
    • Our Services
      • Catalyse - For companies looking for staff augmentation services
      • Launch - Startups and Early Stage Companies
      • Control - Fast-paced tight-deadline projects with moonshot ROI potential
      • Amplify - Scaleups and Hyper-Growth Companies
      • Do's and don'ts
      • Ceremonies
    • Our Partner Programs
      • Agency Partner Program
      • Advisor/Consultant Partner Program
      • Investor Partner Program
      • Developer Tooling Partner Program
  • Employee Handbook
    • How We Work
      • Our Values
      • Our Dream Team
      • Our Leave Policy
      • Out of Office
      • Communication
      • Security Practices
      • Hiring Philosophy
    • Employment Policies
      • Equal Opportunity Employment
      • At-Will Employment Policy
      • Code of Conduct
      • Employee Privacy
      • Compensation
      • Performance Appraisal Policy
        • Timeline for each appraisal cycle
        • Guidelines for Self, Manager, Peer & Colleague Reviews
    • Starting at Wednesday
      • Your first day
        • Onboarding Checklist
      • Becoming a permanent employee
      • Getting Paid
      • Dress Code
      • Work Hours
    • Benefits and Perks
      • Holiday List
      • Paid Time Off
      • Group Health Insurance
      • Conferences
      • Hardware & Software Licenses
  • Engineering Playbook
    • Introduction to Our Engineering Playbook
    • System Architecture & Design
      • Templates
    • Release Engineering
      • Git-flow
      • Code reviews
      • Commit Messages
      • Pull requests
      • Continuous Integration and Delivery
    • Careers in Engineering
      • Hiring Engineers
      • Career Growth
  • DESIGN PLAYBOOK
    • Introduction to Our Design Playbook
    • Who we are
      • Our Journey
    • Why Us
      • Our Values As Designers
    • Careers in Product Design
      • Hiring Designers
  • Project Management Playbook
    • Introduction to Our Project Management Playbook
    • General Guidelines
      • Checklists
        • Internal Checklist
        • Customer Onboarding Checklist
    • Our Approach
      • Agile Ceremonies
        • Sprint Planning
        • Standups
        • Retrospectives & Demos
      • Stakeholder Management
        • Documentation
      • Team Management
    • Careers in Project Management
      • Career Growth
  • Communications
    • Introduction to Our Communications Playbook
    • Content
      • Channels
      • Process
        • Articles
          • Article Structure
            • Introduction Section
            • Instruction Sections
            • Getting Started Section
            • Theory Section
            • Reference Sections
            • "Where to go from here" section
          • Choose your topic
          • Write your outline
            • Research the topic
            • Create your article outline
          • Sample project
            • Follow the four commandments
            • Create a starter project
          • First draft
            • Think of the reader as a beginnner
            • Stay in limit
            • Make it scannable
            • Explain Code
          • Polish your draft
            • Use Hemingway
            • Review as a reader
    • Brand Assets
      • Wednesday
      • The Wednesday University
      • The Wednesday Show
  • Legal Templates
    • Client Contracts
      • Fixed Cost
        • Master Services Agreement for Fixed Cost
        • Statement of Work for Fixed Cost Projects
      • Time and Material
        • Master Services Agreement for T&M
        • Statement Of Work for T&M Projects
    • Personnel Contracts
      • Internship Offer & Intent to Hire
        • Internship Offer Template
        • Annexure 1 - List of Documents for Interns
        • Acknowledgment of Receipt of Playbook for Interns
        • Letter of Intent to Hire
      • Offer cum Appointment Letter for full-time personnel
        • Offer Cum Acceptance Letter Template
        • Annexure 1 - List of Documents for Personnel
        • Acknowledgment of Receipt of Playbook for Personnel
      • Contractor Agreement
        • Contractor Agreement Template
        • Annexure A
  • Elsewhere
    • Our Products
    • The Wednesday Show
    • Wednesday University
Powered by GitBook
On this page

Was this helpful?

Edit on Git
  1. Communications
  2. Content
  3. Process
  4. Articles

Article Structure

Every article at Wednesday follows a defined structure. Get an overview of the various sections to cover in each article here.

Each section in an article has one or more section types.

  1. Introduction: Hook the reader, introduce the topic briefly, and tell the reader what they’ll build and what they’ll learn.

  2. Instruction Sections: Provide the step-by-step instructions for adding code or building the app, and (where possible) end with a “build & run” step and screenshot.

  3. Getting Started Section: The first instruction section in an article is a special case and should cover the initial steps to get started with the rest of the article.

  4. Theory Sections: Explain high-level theory that you need to understand before you dive into the code, usually without step-by-step instructions.

  5. Reference Sections: Lists what options are available for an API / technology for future reference; even those outside of the scope of the tutorial itself.

  6. Where to Go From Here?: Summarizes what the reader has learned, and where they could go for more information or to further expand their skills.

These sections can be composed in any order (except for the Introduction and Where to Go From Here sections which are always first and last).

It’s even possible to combine sections: for example, to have a section that is primarily instruction with some reference or theory.

PreviousArticlesNextIntroduction Section

Last updated 2 years ago

Was this helpful?