Read the Docs                                         Eric Holscher                              http://ericholscher.com  ...
What this talk is                          » Talk about the history of Read the Docs                          » Technology...
Who am I                          » I come from Django                          » Work at Urban Airship                   ...
Why I’m here                          » Feedback                          » Ideas                          » Hopefully you...
The storyThursday, July 28, 2011
2010 Django DashThursday, July 28, 2011
Charles Leifer                          Bobby Grace (Design)                                  MeThursday, July 28, 2011
Doc Hosting Sucks                          » packages.python.org                          » Github Pages                  ...
`Thursday, July 28, 2011
Sphinx                          » Standard documentation tool for python                          » Uses reStructured Text...
Thursday, July 28, 2011
Had a workable site in 48 hoursThursday, July 28, 2011
Fully Open SourceThursday, July 28, 2011
Fully Open Source                          » github.com/rtfd/readthedocs.org                          » github.com/erichol...
Thursday, July 28, 2011
Officially Hosted                          » Celery                          » Fabric                          » Nose, py....
What makes it tickThursday, July 28, 2011
FeaturesThursday, July 28, 2011
Git, Hg, Bzr, SvnThursday, July 28, 2011
Post commit hooksThursday, July 28, 2011
Custom ThemeThursday, July 28, 2011
Full-text searchThursday, July 28, 2011
Tags & Branches = VersionsThursday, July 28, 2011
PDF GenerationThursday, July 28, 2011
VirtualenvsThursday, July 28, 2011
rtfd.orgThursday, July 28, 2011
TechThursday, July 28, 2011
SubdomainsThursday, July 28, 2011
CNAME SupportThursday, July 28, 2011
Cname Support                          » Request for docs.fabfile.org                          » docs.fabfile.org -> fabric....
Architecture                                                         +-----------+                                        ...
Haystack & SolrThursday, July 28, 2011
ChefThursday, July 28, 2011
Nagios & MuninThursday, July 28, 2011
UpstartThursday, July 28, 2011
REST APIThursday, July 28, 2011
CoffeeScriptThursday, July 28, 2011
CLIThursday, July 28, 2011
LessonsThursday, July 28, 2011
Think about your URLs.                               Really hard.Thursday, July 28, 2011
Lay your project out sanelyThursday, July 28, 2011
Write tests!Thursday, July 28, 2011
Build around a standard toolThursday, July 28, 2011
Passing data through systems is                              hardThursday, July 28, 2011
Serving static files is annoyingThursday, July 28, 2011
Log. Everything.Thursday, July 28, 2011
Promote (Hi!)Thursday, July 28, 2011
Find a designer!Thursday, July 28, 2011
Follow the Unix PhilosophyThursday, July 28, 2011
Have a missionThursday, July 28, 2011
Open Source OutcomesThursday, July 28, 2011
PatchesThursday, July 28, 2011
Known architecture informationThursday, July 28, 2011
Slow LorisThursday, July 28, 2011
TrustThursday, July 28, 2011
People Writing DocsThursday, July 28, 2011
DEMOThursday, July 28, 2011
Questions?                          » readthedocs.org / rtfd.org                          » #readthedocs on Freenode      ...
Upcoming SlideShare
Loading in...5
×

Read the Docs: A completely open source Django project

3,183

Published on

This talk goes over the infrastruct

Published in: Technology
0 Comments
3 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
3,183
On Slideshare
0
From Embeds
0
Number of Embeds
0
Actions
Shares
0
Downloads
20
Comments
0
Likes
3
Embeds 0
No embeds

No notes for slide

Read the Docs: A completely open source Django project

  1. 1. Read the Docs Eric Holscher http://ericholscher.com OSCON 2011Thursday, July 28, 2011
  2. 2. What this talk is » Talk about the history of Read the Docs » Technology Involved » Interesting outcomes of opennessThursday, July 28, 2011
  3. 3. Who am I » I come from Django » Work at Urban Airship » Like automating systemsThursday, July 28, 2011
  4. 4. Why I’m here » Feedback » Ideas » Hopefully you’ll learn something too! » Shameless self-promotionThursday, July 28, 2011
  5. 5. The storyThursday, July 28, 2011
  6. 6. 2010 Django DashThursday, July 28, 2011
  7. 7. Charles Leifer Bobby Grace (Design) MeThursday, July 28, 2011
  8. 8. Doc Hosting Sucks » packages.python.org » Github Pages » Your own janky cronjobsThursday, July 28, 2011
  9. 9. `Thursday, July 28, 2011
  10. 10. Sphinx » Standard documentation tool for python » Uses reStructured TextThursday, July 28, 2011
  11. 11. Thursday, July 28, 2011
  12. 12. Had a workable site in 48 hoursThursday, July 28, 2011
  13. 13. Fully Open SourceThursday, July 28, 2011
  14. 14. Fully Open Source » github.com/rtfd/readthedocs.org » github.com/ericholscher/chef-django-example » ericholscher.com/tag/chef-series/Thursday, July 28, 2011
  15. 15. Thursday, July 28, 2011
  16. 16. Officially Hosted » Celery » Fabric » Nose, py.test » Virtualenv, Pip » Django CMS » Django Grapelli/Floppyforms/Sentry » Lots moreThursday, July 28, 2011
  17. 17. What makes it tickThursday, July 28, 2011
  18. 18. FeaturesThursday, July 28, 2011
  19. 19. Git, Hg, Bzr, SvnThursday, July 28, 2011
  20. 20. Post commit hooksThursday, July 28, 2011
  21. 21. Custom ThemeThursday, July 28, 2011
  22. 22. Full-text searchThursday, July 28, 2011
  23. 23. Tags & Branches = VersionsThursday, July 28, 2011
  24. 24. PDF GenerationThursday, July 28, 2011
  25. 25. VirtualenvsThursday, July 28, 2011
  26. 26. rtfd.orgThursday, July 28, 2011
  27. 27. TechThursday, July 28, 2011
  28. 28. SubdomainsThursday, July 28, 2011
  29. 29. CNAME SupportThursday, July 28, 2011
  30. 30. Cname Support » Request for docs.fabfile.org » docs.fabfile.org -> fabric.readthedocs.org » In middleware, resolve CNAME and determine docs to serve. » Cache it.Thursday, July 28, 2011
  31. 31. Architecture +-----------+ | | +-----| Varnish |------+ | +-----------+ | | | +---------+ +---------+ +-------------+ | | | | +--------------+ | |-----| Nginx | | Nginx |----| | | File | +---------+ +---------+ | File | | System | | | | System | +-------------+ +---------+ +--------+ +---------+ +--------------+ | | | | | | | | | | | +---------|Gunicorn |--|Postgres|--|Gunicorn |--------+ | | +---------+ +--------+ +---------+ | | | | | | | | +------------------+ | | | | | +---------------------| Build Server |-------------------+ | | +------------------+Thursday, July 28, 2011
  32. 32. Haystack & SolrThursday, July 28, 2011
  33. 33. ChefThursday, July 28, 2011
  34. 34. Nagios & MuninThursday, July 28, 2011
  35. 35. UpstartThursday, July 28, 2011
  36. 36. REST APIThursday, July 28, 2011
  37. 37. CoffeeScriptThursday, July 28, 2011
  38. 38. CLIThursday, July 28, 2011
  39. 39. LessonsThursday, July 28, 2011
  40. 40. Think about your URLs. Really hard.Thursday, July 28, 2011
  41. 41. Lay your project out sanelyThursday, July 28, 2011
  42. 42. Write tests!Thursday, July 28, 2011
  43. 43. Build around a standard toolThursday, July 28, 2011
  44. 44. Passing data through systems is hardThursday, July 28, 2011
  45. 45. Serving static files is annoyingThursday, July 28, 2011
  46. 46. Log. Everything.Thursday, July 28, 2011
  47. 47. Promote (Hi!)Thursday, July 28, 2011
  48. 48. Find a designer!Thursday, July 28, 2011
  49. 49. Follow the Unix PhilosophyThursday, July 28, 2011
  50. 50. Have a missionThursday, July 28, 2011
  51. 51. Open Source OutcomesThursday, July 28, 2011
  52. 52. PatchesThursday, July 28, 2011
  53. 53. Known architecture informationThursday, July 28, 2011
  54. 54. Slow LorisThursday, July 28, 2011
  55. 55. TrustThursday, July 28, 2011
  56. 56. People Writing DocsThursday, July 28, 2011
  57. 57. DEMOThursday, July 28, 2011
  58. 58. Questions? » readthedocs.org / rtfd.org » #readthedocs on Freenode » github.com/rtfd/readthedocs.org » eric@ericholscher.comThursday, July 28, 2011
  1. A particular slide catching your eye?

    Clipping is a handy way to collect important slides you want to go back to later.

×