I have worked in:

• AutoHotkey
• JavaScript (early web)
• JavaScript (today)
• AS400 Databases
• SQL
• Powershell
• PCL
• COBOL
• ASP.NET
• VBScript
• C++
• Visual Basic 3, 5 and 6
• C#
• ColdFusion
• Python
• ARGOStore
• ARGL
• PCL
• GCode
• R
• Java
• XSL Template (a turing complete language)
•  

Learning a new environment sucks because of poor documentation

[add: illustrative koan about beginner's mind]

[add: super predictable stacked river stones picture]

Don't orient your documentation around your frame of reference. ☸️

Your customers aren't your team,

that's why they need the docs. 🤷‍♀️ 🤷‍♂️

What a junior developer can understand

gets used. 👧👦

If they teach it in a bootcamp

It's mainstream. 📈

Be learning a new skill,

always. 👩‍🎓👨‍🎓

Forge new territory;

learn things outside of software.   👩‍🏭👨‍🔧👩‍🌾👨‍🎤

Teach.  👩‍🏫👨‍🏫

#notallpackages

Quickstart

🛠📚🐯🐅🦍

Use

Your docs need to be playgrounds

Overview

📚🐯🐅🦍

Multiple audiences?

Overview

API Documentation

🛠📚🐯🐅🦍

API Documentation

API Documentation should be generated

Walkthroughs

📚🐅🦍

Demos

📚🐯🐅🦍

Walkthroughs and Demos

Better Together 🌈

Courses

A course isn't about content

Exercises

Junior Developers need a chance to practice first.

Courses

Instructional design (ID), or instructional systems design (ISD), is the practice of creating "instructional experiences which make the acquisition of knowledge and skill more efficient, effective, and appealing."

🐅? 🦍++

You don't know educational theory.

Hire an expert.

Emoji

Emoji

🐛 - Bug

🦋 - Design Bug

🐞 - Won't Fix

🚨 - Urgent Issue

🎉 - Verified Fixed

Emoji

How many 🚨?

Org-wide: Use a consistent format

Tone

Tone

Not all junior developers are millenials

Create a tone styleguide that fits your audience

Diagrams

To help engineers on the autism spectrum

include a diagram

Unmaintained Walkthroughs

Get your docs

translated.

Silicon Valley isn't the center of the universe.      🌉🌌