Git Product home page Git Product logo

writethedocsna2015's Introduction

Write the Docs NA 2015

These are the references and materials for my Write the Docs NA 2015 talk. Feel free to ask questions (or just say "Hi") by opening issues.

What's in this repo

I've put together a list of pretty much everything associated with my talk at the conference including:

Submitted abstract

The title for my conference talk was:

The Making of Writing Black Belts: How Martial Arts Philosophy Forged an Ad-Hoc Writing Team that Writes Great Docs

and I submitted this abstract:

At Fastly, a San Francisco-based content delivery network startup company, I’ve learned that almost every one of my co-workers, regardless of their job function, is willing to write our company’s documentation. Whether they realize it or not, each one of them has ventured onto the path of becoming a “writing team black belt.”

In this talk I’ll discuss how my company has unwittingly followed the seven (and a half) rules I normally associate with becoming a great martial artist. I’ll discuss how we’ve been using these rules to forge an amazing ad-hoc documentation team with no formal department and no squad of strategically placed technical writers. I’ll talk about how my company has managed it despite the obstacles of startup life, including moving seven times and growing from less than 30 employees when I first joined to a throng of more than 150 a mere year and a half later. Finally, I’ll point out some of our successes, a few of our failures, and how each of the seven (and a half) rules has taught us what it means to write Fastly.

(Just in case, I've got a screenshot of the abstract as it appeared on the Write the Docs conference speakers page.)

Thanks, gratitude, and accountability

In the spirit of full disclosure, the proposal for this talk was submitted in large part due to a late-night bout with insomnia. I am forever grateful to my coworkers for encouraging me to accept the 15-minute speaking time slot even though I had outlined a talk that would easily span 45 minutes. Or more. Possibly much more.

Most of the ideas in this talk are not mine to begin with. They are the direct result of my study as a martial artist under the tutelage of Sifu Robert Brown at the School of Martial Arts in Berkley, Michigan. If any of the concepts about martial arts or the philosophy behind it are inaccurate in any way whatsoever, it is I, not he, who should be held accountable for the misrepresentation.

I am not a master. I am but an egg.

the logo for Write the Docs, as it appears on their sticker

writethedocsna2015's People

Contributors

gaylin avatar

Stargazers

 avatar

writethedocsna2015's Issues

As a speaker, I want a text version created of my talk

I want to make sure that if someone doesn't want to spend the time watching the video of me speaking that they can read the text of my talk for themselves. This can either take the form of the actual transcript of the talk, or the speaker notes I used while giving the talk.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.