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