60
Read the Docs Eric Holscher http://ericholscher.com OSCON 2011 Friday, July 22, 2011

Read the Docs - O'Reilly Mediaassets.en.oreilly.com/1/event/61/A Completely Open Source Django... · » Talk about the history of Read the Docs ... » I come from Django » Work at

  • Upload
    vuthien

  • View
    216

  • Download
    3

Embed Size (px)

Citation preview

Read the Docs

Eric Holscherhttp://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

Officially 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 LeiferBobby 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

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

CoffeeScript

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 LorisFriday, 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

» [email protected]

» twitter.com/ericholscher

» Urban Airship

Friday, July 22, 2011