The Self Documenting Developer -- WordCamp Phoenix 2020

•

0 likes•597 views

Maura Teal

Slides from my presentation at WordCamp Phoenix 2020.

Software

@mlteal | #WCPHX | 2020
The Self-Documenting
Developer

@mlteal | #WCPHX | 2020
Back in the day…

@mlteal | #WCPHX | 2020
1. https://books.google.com/books?id=pq-eT9Lz6gkC&lpg=PA91&pg=PA87#v=onepage&q&f=false

@mlteal | #WCPHX | 2020
“In many shops, more
time is spent trying to
understand software
than [any other task]”
1. https://books.google.com/books?id=pq-eT9Lz6gkC&lpg=PA91&pg=PA87#v=onepage&q&f=false

@mlteal | #WCPHX | 2020
A Little 90’s Nostalgia
1. https://thenextweb.com/insider/2011/08/06/20-years-ago-today-the-world-wide-web-opened-to-the-public/

@mlteal | #WCPHX | 2020
Code is constantly changing

@mlteal | #WCPHX | 2020
In the modern world

@mlteal | #WCPHX | 2020
Making sense of it all

@mlteal | #WCPHX | 2020
Rules to live by
• Start simple
• Document as you go
• Comment your code

@mlteal | #WCPHX | 2020
Rules to live by
• Start simple
• Document as you go
• Note where your projects
and processes live

@mlteal | #WCPHX | 2020
You decide what you support

@mlteal | #WCPHX | 2020
New feature =
New documentation

@mlteal | #WCPHX | 2020
Create & share
the process• Slack request -> GH Issue
• Slack question -> GH README reference 
-> GH Code reference
• Email request -> GH Issue

@mlteal | #WCPHX | 2020
• GitHub Issue Update -> Slack
• New Release -> Slack
• Documentation updated -> note in Slack
• Via Daily/Weekly Standups (Standuply
Bot)
• Via CI/CD pipeline (we use Storybook
and Redoc)
1. https://standuply.com/
2. https://storybook.js.org/
3. https://github.com/Redocly/redoc

@mlteal | #WCPHX | 2020
Integrations FTW

@mlteal | #WCPHX | 2020
Good documentation
comes from those
who build & use the
product

@mlteal | #WCPHX | 2020
Maura Teal
@mlteal

Similar to The Self Documenting Developer -- WordCamp Phoenix 2020

Build the right it before you build it right

riscutiatudor

Fa102a assignment 2

Adam Palasciano

Fa102a Assignment 2

Adam Palasciano

EIUG Edinburgh Joe Murphy librarian futurist

Joe Murphy Librarian & Futurist

PixieDust is a new open source library that helps data scientists and developers working in Jupyter Notebooks and Apache Spark be more efficient. PixieDust speeds up data manipulation and display with features like: auto-visualization of Spark DataFrames, real-time Spark job progress monitoring, automated local install of Python and Scala kernels running with Spark, and much more. Come along and learn how you can use this tool in your own projects to visualize and explore data effortlessly with no coding. Oh, and if you prefer working with a Scala Notebook, this session is also for you, as PixieDust can also run on a Scala Kernel. Imagine being able to visualize your favorite Python chart engines from a Scala Notebook! We’ll finish the session with a demo combining Twitter, Watson Tone Analyzer, Spark Streaming, and some fun real-time visualizations–all running within a Notebook.

Taking Jupyter Notebooks and Apache Spark to the Next Level PixieDust with Da...

Databricks

Balancing Act of Caching LoopConf 2018

Maura Teal

Causing Economic Development Action with Effective Communications

Christa Ouderkirk Franzi

Creating an Open Source Office: Lessons from Twitter

Chris Aniszczyk

With the rising popularity of working in more agile ways, we’ve been taught to move away from the big old projects of yore and focus instead on smaller, actionable outcomes. But what happens when you’re trying to achieve a massive vision of large-scale, long-term change; in this case working to get an entire sector to change its relationship with digital, technology, and collaboration? Real change and transformation can be extremely difficult, take a long time, and be a rocky road to tread. In this case study-led talk I’ll tell the story of how I’ve been part of a team working to combat inactivity, spark innovation, and create a better online customer experience around sport and physical activity through open data. I’ll be speaking about the process of change, the balance between technology and people, lessons learned, and how these all relate to our work with the web. Using a series of practical demonstrations spanning data visualisation, neural networks, JAMstack web development, online tools like glitch.me, and Google Sheets as a data store I’ll also show how development skills can be a powerful tool within transformation projects. You will leave armed with new practical tips and ideas, and hopefully inspired to make some positive change in the world.

Changing the world with the web

Sally Lait

Product Management & Statistics - ProductTank Helsinki 04/2020

Marjukka Niinioja

Fa102a assignment 2

Adam Palasciano

Developers building applications on Kubernetes today are being asked to not just code applications -- they are also responsible for shipping and running their applications, too. We often talk about needing a Kubernetes platform, but are we really looking for a PaaS? Or instead, are we looking for some kind of developer control plane with a Goldilock-sized collection of tools that provides just the right amount of platform? This talk will look back on my experience of building platforms, both as an end-user and now as part of an organization helping our customers do the same. We’ll wrap this talk with a walk-through of the CNCF ecosystem through the developer control plane lens, and look at what’s next in the future of this important emerging category.

Fall 22: "From Kubernetes to PaaS to... err, what's next"

Daniel Bryant

Mike King - Futureproofing your SEO

Autumn Quarantotto

Mike King - Futureproofing your SEO

Julia Grosman

How Generative Machine Learning will Change Content Creation Forever

LucaMarchesotti

How (Docker) Community changed my life

Karoly Kass

TechSEO Boost 2019: Research Competition

Catalyst

Technology in My Classroom? Yikes!

Jackie Gerstein, Ed.D

LONE RANGER VS. THE BIG AGENCY - THE TOOLS, PROCESS AND TECHNIQUES SESSION

Social Media Club Atlanta

Intro to data visualisation

Anna Gerber

Recently uploaded

WSO2Con2024 - Enabling Transactional System's Exponential Growth With Simplicity

WSO2

WSO2Con204 - Hard Rock Presentation - Keynote

WSO2

WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...

WSO2

We specialize in Psychic Readings, Psychic Love Spells, Binding Love Spells, Obsession Spells, Voodoo Spells, Lottery Spells, Marriage Spells, Black Magic Spells, Palm Readings & much more. Are you depressed? We perform this come-to-me love spell that works instantly with the aim of bringing back the victim to the person performing the magic. Have you lost your lover? We perform this come-to-me love spell that works instantly with the aim of bringing back the victim to the person performing the magic. Have you lost your lover? Do u need to solve any relationship problem? Contact the powerful spells caster chief kule with love spells that work overnight and love spells that really work. Have you found yourself infatuated with a special someone you think could be the one? Are you looking for a spell to provide them with a nudge in the right direction? Or maybe the spell you cast didn’t achieve the results you were hoping for? Whether you’re new or versed in the ways of spell casting, we’re here to help. Today we’re going to provide you with a detailed guide on the types of love spells to cast. Not only that but there’s something for those who wish to find outside advice from more advanced spell casters. We’re also going to provide you with the top sites available to help you with your dilemma. Let’s begin our journey by educating ourselves on love magic and what a real love caster looks like. Love Magic and Love Casters Love magic made its first appearance back in Ancient Egypt and has been an active practice since. This type of magic is a branch of traditional magic and can be practiced in various ways. Typically the more common use of love magic is through the work of spells, but other methods look like Charms Rituals-LOVE Potions-Dolls and even Amulets If you are interested in becoming a love caster, be prepared for what’s to come. A genuine love caster knows that the art of love casting is no easy feat and shouldn’t be done casually. You should know that not only does it require you to be gifted spiritually, but you must be ready to serve others. Someone who is considered a real love caster has experience in all manner of spells, no matter the difficulty. Training yourself in attraction, commitment, and marriage spells is an excellent place to start. But this by no means will make you a professional. Practice your craft and expand your knowledge; understand that you will possess the ability to help others in time truly. Types of Love Spells What better way to start broadening your experiences with love spells than by learning more about them? These spells work like just about any other spell. Simply apply your intention, use a medium (sigils, mantras, candles, or charm bags), and top it off with establishing the belief that you will receive what you want. So what kind of spells are available and which ones suit your needs the best? Let’s take a look at the many options you have at your disposal.

%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...

masabamasaba

Artyushina_Guest lecture_YorkU CS May 2024.pptx

AnnaArtyushina1

Craft an AI & Machine Learning Pitch with our Editable Professional PowerPoint Template. Ignite your AI & Machine Learning pitch with our cutting-edge PowerPoint template tailored for the industry. Perfect for AI conferences, investor presentations, sales pitches to tech-focused companies, training sessions, and educational programs. - 20+ editable slides: Get a variety of options to choose from for your presentation. - Time-saving solution: Download, replace text/images with a few clicks. - User-friendly customization: Easy to use and personalize. - Modern and attractive design: Captivating visuals, sleek layout. - Tailored to your requirements: Fully alterable for customization. - Well-organized slides: Complete control over content. - Thematic specificity: Reflects healthcare industry with relevant graphics. - Showcase your business idea: Communicate value proposition effectively.

AI & Machine Learning Presentation Template

Presentation.STUDIO

WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...

WSO2

We specialize in Psychic Readings, Psychic Love Spells, Binding Love Spells, Obsession Spells, Voodoo Spells, Lottery Spells, Marriage Spells, Black Magic Spells, Palm Readings & much more. Are you depressed? We perform this come-to-me love spell that works instantly with the aim of Winnipeg back the victim to the person performing the magic. Have you lost your lover? We perform this come-to-me love spell that works instantly with the aim of bringing back the victim to the person performing the magic. Have you lost your lover? Do u need to solve any relationship problem? Contact the powerful spells caster chief kule with love spells that work overnight and love spells that really work. Have you found yourself infatuated with a special someone you think could be the one? Are you looking for a spell to provide them with a nudge in the right direction? Or maybe the spell you cast didn’t achieve the results you were hoping for? Whether you’re new or versed in the ways of spell casting, we’re here to help. Today we’re going to provide you with a detailed guide on the types of love spells to cast. Not only that but there’s something for those who wish to find outside advice from more advanced spell casters. We’re also going to provide you with the top sites available to help you with your dilemma. Let’s begin our journey by educating ourselves on love magic and what a real love caster looks like. Love Magic and Love Casters Love magic made its first appearance back in Ancient Egypt and has been an active practice since. This type of magic is a branch of traditional magic and can be practiced in various ways. Typically the more common use of love magic is through the work of spells, but other methods look like Charms Rituals-LOVE Potions-Dolls and even Amulets If you are interested in becoming a love caster, be prepared for what’s to come. A genuine love caster knows that the art of love casting is no easy feat and shouldn’t be done casually. You should know that not only does it require you to be gifted spiritually, but you must be ready to serve others. Someone who is considered a real love caster has experience in all manner of spells, no matter the difficulty. Training yourself in attraction, commitment, and marriage spells is an excellent place to start. But this by no means will make you a professional. Practice your craft and expand your knowledge; understand that you will possess the ability to help others in time truly. Types of Love Spells What better way to start broadening your experiences with love spells than by learning more about them? These spells work like just about any other spell. Simply apply your intention, use a medium (sigils, mantras, candles, or charm bags), and top it off with establishing the belief that you will receive what you want. So what kind of spells are available and which ones suit your needs the best? Let’s take a look at the many options you have at your disposal. Attraction Spells

%+27788225528 love spells in Knoxville Psychic Readings, Attraction spells,Br...

masabamasaba

%in Midrand+277-882-255-28 abortion pills for sale in midrand

masabamasaba

VTU technical seminar 8Th Sem on Scikit-learn

AmarnathKambale

MarTech Trend 2024 Book : Marketing Technology Trends (2024 Edition) How Data...

Jittipong Loespradit

WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...

WSO2

WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...

WSO2

%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...

masabamasaba

WSO2CON 2024 Slides - Open Source to SaaS

WSO2

OpenChain - The Ramifications of ISO/IEC 5230 and ISO/IEC 18974 for Legal Pro...

Shane Coughlan

WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation

WSO2

WSO2CON 2024 - Navigating API Complexity: REST, GraphQL, gRPC, Websocket, Web...

WSO2

+971565801893 Mtp-Kit (500MG) Prices » Dubai [(+971565801893**)] Abortion Pills For Sale In Dubai, UAE, Mifepristone and Misoprostol Tablets Available In Dubai, UAE CONTACT DR.Leen Whatsapp +971565801893 We Have Abortion Pills / Cytotec Tablets /Mifegest Kit Available in Dubai, Sharjah, Abudhabi, Ajman, Alain, Fujairah, Ras Al Khaimah, Umm Al Quwain, UAE, Buy cytotec in Dubai +971565801893''''Abortion Pills near me DUBAI | ABU DHABI|UAE. Price of Misoprostol, Cytotec” +971565801893' Dr.DEEM ''BUY ABORTION PILLS MIFEGEST KIT, MISOPROTONE, CYTOTEC PILLS IN DUBAI, ABU DHABI,UAE'' Contact me now via What's App…… abortion Pills Cytotec also available Oman Qatar Doha Saudi Arabia Bahrain Above all, Cytotec Abortion Pills are Available In Dubai / UAE, you will be very happy to do abortion in Dubai we are providing cytotec 200mg abortion pill in Dubai, UAE. Medication abortion offers an alternative to Surgical Abortion for women in the early weeks of pregnancy. We only offer abortion pills from 1 week-6 Months. We then advise you to use surgery if its beyond 6 months. Our Abu Dhabi, Ajman, Al Ain, Dubai, Fujairah, Ras Al Khaimah (RAK), Sharjah, Umm Al Quwain (UAQ) United Arab Emirates Abortion Clinic provides the safest and most advanced techniques for providing non-surgical, medical and surgical abortion methods for early through late second trimester, including the Abortion By Pill Procedure (RU 486, Mifeprex, Mifepristone, early options French Abortion Pill), Tamoxifen, Methotrexate and Cytotec (Misoprostol). The Abu Dhabi, United Arab Emirates Abortion Clinic performs Same Day Abortion Procedure using medications that are taken on the first day of the office visit and will cause the abortion to occur generally within 4 to 6 hours (as early as 30 minutes) for patients who are 3 to 12 weeks pregnant. When Mifepristone and Misoprostol are used, 50% of patients complete in 4 to 6 hours; 75% to 80% in 12 hours; and 90% in 24 hours. We use a regimen that allows for completion without the need for surgery 99% of the time. All advanced second trimester and late term pregnancies at our Tampa clinic (17 to 24 weeks or greater) can be completed within 24 hours or less 99% of the time without the need surgery. The procedure is completed with minimal to no complications. Our Women's Health Center located in Abu Dhabi, United Arab Emirates, uses the latest medications for medical abortions (RU-486, Mifeprex, Mifegyne, Mifepristone, early options French abortion pill), Methotrexate and Cytotec (Misoprostol). The safety standards of our Abu Dhabi, United Arab Emirates Abortion Doctors remain unparalleled. They consistently maintain the lowest complication rates throughout the nation. Our Physicians and staff are always available to answer questions and care for women in one of the most difficult times in their lives. The decision to have an abortion at the Abortion Clinic in Abu Dhabi, United Arab Emirates.+971565801893

+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...

Health

WSO2CON2024 - It's time to go Platformless

WSO2

Recently uploaded (20)

WSO2Con2024 - Enabling Transactional System's Exponential Growth With Simplicity

WSO2Con204 - Hard Rock Presentation - Keynote

WSO2CON 2024 - API Management Usage at La Poste and Its Impact on Business an...

%+27788225528 love spells in Colorado Springs Psychic Readings, Attraction sp...

Artyushina_Guest lecture_YorkU CS May 2024.pptx

AI & Machine Learning Presentation Template

WSO2CON 2024 - Cloud Native Middleware: Domain-Driven Design, Cell-Based Arch...

%+27788225528 love spells in Knoxville Psychic Readings, Attraction spells,Br...

%in Midrand+277-882-255-28 abortion pills for sale in midrand

VTU technical seminar 8Th Sem on Scikit-learn

MarTech Trend 2024 Book : Marketing Technology Trends (2024 Edition) How Data...

WSO2Con2024 - From Code To Cloud: Fast Track Your Cloud Native Journey with C...

WSO2CON 2024 - WSO2's Digital Transformation Journey with Choreo: A Platforml...

%+27788225528 love spells in Atlanta Psychic Readings, Attraction spells,Brin...

WSO2CON 2024 Slides - Open Source to SaaS

OpenChain - The Ramifications of ISO/IEC 5230 and ISO/IEC 18974 for Legal Pro...

WSO2Con2024 - WSO2's IAM Vision: Identity-Led Digital Transformation

WSO2CON 2024 - Navigating API Complexity: REST, GraphQL, gRPC, Websocket, Web...

+971565801893>>SAFE AND ORIGINAL ABORTION PILLS FOR SALE IN DUBAI AND ABUDHAB...

WSO2CON2024 - It's time to go Platformless

The Self Documenting Developer -- WordCamp Phoenix 2020

1. @mlteal | #WCPHX | 2020 The Self-Documenting Developer

2. Maura Teal (@mlteal) Software Engineer at Pagely and NorthStack @mlteal | #WCPHX | 2020

3. @mlteal | #WCPHX | 2020 Back in the day…

4. @mlteal | #WCPHX | 2020 1. https://books.google.com/books?id=pq-eT9Lz6gkC&lpg=PA91&pg=PA87#v=onepage&q&f=false

5. @mlteal | #WCPHX | 2020 “In many shops, more time is spent trying to understand software than [any other task]” 1. https://books.google.com/books?id=pq-eT9Lz6gkC&lpg=PA91&pg=PA87#v=onepage&q&f=false

6. @mlteal | #WCPHX | 2020 A Little 90’s Nostalgia 1. https://thenextweb.com/insider/2011/08/06/20-years-ago-today-the-world-wide-web-opened-to-the-public/

7. @mlteal | #WCPHX | 2020

8. @mlteal | #WCPHX | 2020 Code is constantly changing

9. @mlteal | #WCPHX | 2020 Accept it.

10. @mlteal | #WCPHX | 2020 In the modern world

11. @mlteal | #WCPHX | 2020 Making sense of it all

12. @mlteal | #WCPHX | 2020 Rules to live by • Start simple • Document as you go • Comment your code

13. @mlteal | #WCPHX | 2020 Rules to live by • Start simple • Document as you go • Note where your projects and processes live

14. @mlteal | #WCPHX | 2020

15. @mlteal | #WCPHX | 2020 You decide what you support

16. @mlteal | #WCPHX | 2020 New feature = New documentation

17. @mlteal | #WCPHX | 2020 Create & share the process• Slack request -> GH Issue • Slack question -> GH README reference  -> GH Code reference • Email request -> GH Issue

18. @mlteal | #WCPHX | 2020 • GitHub Issue Update -> Slack • New Release -> Slack • Documentation updated -> note in Slack • Via Daily/Weekly Standups (Standuply Bot) • Via CI/CD pipeline (we use Storybook and Redoc) 1. https://standuply.com/ 2. https://storybook.js.org/ 3. https://github.com/Redocly/redoc

19. @mlteal | #WCPHX | 2020 Integrations FTW

20. @mlteal | #WCPHX | 2020 Good documentation comes from those who build & use the product

21. @mlteal | #WCPHX | 2020

22. @mlteal | #WCPHX | 2020 Maura Teal @mlteal

The Self Documenting Developer -- WordCamp Phoenix 2020

Recommended

Recommended

More Related Content

Similar to The Self Documenting Developer -- WordCamp Phoenix 2020

Similar to The Self Documenting Developer -- WordCamp Phoenix 2020 (20)

Recently uploaded

Recently uploaded (20)

The Self Documenting Developer -- WordCamp Phoenix 2020