Read the Docs Eric Holscher http://ericholscher.com OSCON 2011 - - PowerPoint PPT Presentation

Read the Docs

Eric Holscher http://ericholscher.com OSCON 2011

Friday, July 22, 2011

What this talk is

» Talk about the history of Read the Docs » Technology Involved » Interesting outcomes of openness

Friday, July 22, 2011

Who am I

» I come from Django » Work at Urban Airship » Like automating systems

Friday, July 22, 2011

Why I’m here

» Feedback » Ideas » Hopefully you’ll learn something too! » Shameless self-promotion

Friday, July 22, 2011

Friday, July 22, 2011

Offjcially Hosted

» Celery » Fabric » Pip » Virtualenv » Django CMS » Django Grapelli/Floppyforms/Sentry » Lots more

Friday, July 22, 2011

The story

Friday, July 22, 2011

2010 Django Dash

Friday, July 22, 2011

Charles Leifer Bobby Grace (Design) Me

Friday, July 22, 2011

Doc Hosting Sucks

» packages.python.org » Github Pages » Your own janky cronjobs

Friday, July 22, 2011

Friday, July 22, 2011

Had a workable site in 48 hours

Friday, July 22, 2011

Fully Open Source

Friday, July 22, 2011

Fully Open Source

» github.com/rtfd/readthedocs.org » github.com/ericholscher/chef- django-example » ericholscher.com/tag/chef-series/

Friday, July 22, 2011

Friday, July 22, 2011

No excuse

Friday, July 22, 2011

What makes it tick

Friday, July 22, 2011

Features

Friday, July 22, 2011

Git, Hg, Bzr, Svn

Friday, July 22, 2011

Post commit hooks

Friday, July 22, 2011

Custom Themes

Friday, July 22, 2011

Full-text search

Friday, July 22, 2011

Tags & Branches

Friday, July 22, 2011

PDF Generation

Friday, July 22, 2011

Man Pages

Friday, July 22, 2011

Virtualenvs

Friday, July 22, 2011

Tech

Friday, July 22, 2011

Sphinx

Friday, July 22, 2011

Subdomains

Friday, July 22, 2011

CNAME Support

Friday, July 22, 2011

Haystack & Solr

Friday, July 22, 2011

Celery

Friday, July 22, 2011

Varnish

Friday, July 22, 2011

Chef

Friday, July 22, 2011

Multiple Servers

Friday, July 22, 2011

Architecture

+-----------+ | | +-----| Varnish |------+ | +-----------+ | | | +---------+ +---------+ +-------------+ | | | | +--------------+ | |-----| Nginx | | Nginx |----| | | File | +---------+ +---------+ | File | | System | | | | System | +-------------+ +---------+ +--------+ +---------+ +--------------+ | | | | | | | | | | | +---------|Gunicorn |--|Postgres|--|Gunicorn |--------+ | | +---------+ +--------+ +---------+ | | | | | | | | +------------------+ | | | | | +---------------------| Build Server |-------------------+ | | +------------------+

Friday, July 22, 2011

Nagios & Munin

Friday, July 22, 2011

Nginx & Gunicorn

Friday, July 22, 2011

Upstart

Friday, July 22, 2011

REST API

Friday, July 22, 2011

CofgeeScript

Friday, July 22, 2011

CLI

Friday, July 22, 2011

Lessons

Friday, July 22, 2011

Think about your URLs. Really hard.

Friday, July 22, 2011

Lay your project out sanely

Friday, July 22, 2011

Write tests!

Friday, July 22, 2011

Build around a standard tool

Friday, July 22, 2011

Promote (Hi!)

Friday, July 22, 2011

Find a designer!

Friday, July 22, 2011

• Log. Everything.

Friday, July 22, 2011

Follow the Unix Philosophy

Friday, July 22, 2011

Have a mission

Friday, July 22, 2011

Open Source Outcomes

Friday, July 22, 2011

Patches

Friday, July 22, 2011

Known architecture information

Friday, July 22, 2011

Slow Loris

Friday, July 22, 2011

Trust

Friday, July 22, 2011

People Writing Docs

Friday, July 22, 2011

DEMO

Friday, July 22, 2011

Questions?

» readthedocs.org / rtfd.org » #readthedocs on Freenode » github.com/rtfd/readthedocs.org » eric@ericholscher.com » twitter.com/ericholscher » Urban Airship

Friday, July 22, 2011