From 577cf29f64aa68c5a1c89e1b8d84528ed6a1cd37 Mon Sep 17 00:00:00 2001
From: Joe Nelson <cred+github@begriffs.com>
Date: Mon, 10 Oct 2016 01:15:33 -0700
Subject: [PATCH] Intro section

---
 _static/logo.png | Bin 0 -> 8149 bytes
 index.rst        |  55 +++++++++++++++++++++++-----
 intro.rst        |  92 +++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 138 insertions(+), 9 deletions(-)
 create mode 100644 _static/logo.png
 create mode 100644 intro.rst

diff --git a/_static/logo.png b/_static/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..030673cfbaa40c2bc994436ff1aa67cab3a01d0e
GIT binary patch
literal 8149
zcmeAS@N?(olHy`uVBq!ia0y~yVAf|~VA#mP%)r3#tGs9p0|R4TfKQ04dx1|+PY(kF
z!@Ya=7#JA#?%n(0!v_Wi1~xXfZ{NP%ym|A?nKO?cKmPXZ+wR@FKY_uwZ{NOt{rc+F
zs~0a`eE9I;_3PJPzkdDv`SX`AUp{~S{O;Ymw{PFR2ZJwPzI^)h>HGKZT3IuG{`~Rl
z=TAuyvERRcYh+HBk&t9yVEFd!n|j9dFJHd={rmUBr!Ok$)84&%_wnN=M+b-encH8z
zdeyLGzn-?vrAwESlasGKc(H%q{(a}~%$hk%K~^p<HrCR@BDigJS!t<B;oQuO3=R&C
z+qZA~`1r*2tUrACuv^_yb!C;QQ>Q+A_RQGGNI!3uedVImNt+|WBdV&Z?mm0#=IVC;
z{{5z=riyvHw{P1P6cn^}&Dy@czRjC9y?pnnAitnz&C#>Bo;-g1c=__>r%#=F{ObLx
zLsza}zrK6-?)kgUb#``cJ$ZB9ym`lu9k(o<f9~A**4Ea=ix$<^)=t}UN<ctx;)dgg
zFF!bW{ZV6GeSJeiNqObV3mWqo7#I{wg8YIRgqc0q>|z)>zuM>pzf{=0{{6ke%y|_T
z4qiWA*V;4r?D?Ysk3KRm$bR*7aSW-5OHyF$X$myp`cZL%qdCxk%Z<_8nwgndT)#oq
z`jxL#&m)6<C21*~=EsiCj@@gk^K}c$?t?cBgaoYSa2U*;;H%qN?4ZUr{i>w>zK>3i
zdAF!U?|Jcg_bc&=Pw%UJY#45brRh%IAl?wSre!a~jk<)jk>z)|9rPLGmhTmBh-0W?
ze8IW^%!sVdc*IySWrsM!7p4m!6?>tK*=lkPy4rVPTm~@1TW$6daR%xCo5dSy8E=R)
zytDnnv_YTYPUwAohToISJsH0|nq|#$ft$g+QlDYd_Y2$y{!29Eys713_^q_*_3uhU
zZKmIwCLW4AvcKZ;+Pyz=gqZJa`KB~?*}t&8eX}JR;_fVb_4D)UO>XbQU$K5kTDo4`
zGV8U*ni#)tTWa^1NHoM1T~?S?|MI%_=WW;2yqg(cJk_~jDRJ9BKCZ53%hya#1BSgP
zmaGa-yja-vQ0Kz3{Z0lC_T~qv+h3adGV|`{@7(u8+IM$0G44&dbhFzhE6VQ2#qU+-
zb-~RuJK1-<)_i;P#O77otRA;rmMD+<^~A?VX@Pk5;UyDd*l&H=f7|bW*`=$WY|<IN
zr3#+p4~-Y^>I=8GUH58tqeMe(q>ER(l&|)BnfEGtI=*ahF-V9Po4nX|E$=bg+xPTq
z9(b^QOSPQo_RCDCs_gwS`AmaiUz-c3r+I3AU+xy4FTL%q#PoBI`%)b2?(RLYVD;G#
zM;?28oBqV*$@%S1j{ISs{qo(>KS}TR%oh&d#<FK+R`A<v?{0@gORqXIF<|?JQ~^h}
z97eN)3Y!`gB{py#Yv}!aBmdv;w`|FZE}wqvd%ah=wmggNO8d6@3+2&wYkx5;pYd$s
z&7A$4U5yg1Gc)|UkbA&s&E^t2IlIbbA?@PNRn@tp%%d5zYkt1`eB#nl8_{JKUj556
zIyuMre$+X=Z{B_h&%VsBxqYKPI#Hk3cH-hWXTPO(HQOwAvk_Nq{G!HNySqTq$lf^N
z*GE^bhXJo|Br5-yqui74`os1|(VtY^zB_@de&yEPcT)JDD$Q@u%{yml4&S|H&E-#m
z{8bySeViV<qU+j^Pr=FikG`Asyt~)nw94+^u|4`nKKNRwrR!FFRXuv!?D34BN^jhA
zOs+WYIv4oD!dd^rwi9;F>Xo+(L)LzL`n+xLp`v5vd&Pg8w3vLrOQ7!lK8v*PJC^gm
z|C~Cf{DS$;j^~L#YW#kbeGKrp`NGw%{-V~0v`<H+;u~U5>a$yT*Dn0<^SP~L`u8`l
zpKsXE=KtYn;Eni$KTb~G<lFnvbC&+RzrIs4?o^&~v@3aX^Sv>{8xgi62aXo@sbBy6
z`14cwk~6n|JpOp;YC}TX*Nydtjrw!<Uj0${^KE2v{}eqzzb{_|3j<#twT^H-&idi@
z?;z0|q6SG1H1m~ZdK2Gq|NnA&o2%~f{8dL=C-1w=kYVfd<K?G?bFV)9G9mt;^1nH+
zlc(ti2_6q?`k4Fw?Zl&w{n2{tTDH?FS=T)Yo$~kPJdXW4_0L`HRjBFyaGBM9#_ytI
zMza&of3~^1RkX+V(9t7q6%kpJmhH2cIbZ0s_{Y`Ns)lPO{1xY&|5^K(VXQ~s>UKu<
z3{{y^`$8T}uD#gsmvis${cqoK^Su19>(@8&^J&idGmeX&7I*uS)>ARN|40AYqbG~=
zUVM6d<6zQ;?!+(qG^#F$EZxCA|4nz>i^ne~Y}l>uG<989Z+M%dz0=$1j4d^Wj2oEp
zWz#d8HnG`DmY<67J;da_uchgr_gni<YO-gQoIWmA=3(Ieu=>ZLck(wq8a8a!*S(}T
zpX<P@YwEvNR2|ER*f&Gyp~&%FOF7m@3w<?+?GfH}*uW}&hx2bCg|D}?oL;#8nqcri
z>J4wq{x1E1t_cl~udUnXP%p-x{bu$Dvvzl*?fTR73r;><aXCG@rJp75(2tK^Dc628
z9eaJRnss3gzg?KK!Rog44;SytU_4%X;rFJa>zj&WwcjdVVn02-{-5=u)A4_;lihCY
zkWSZrtUOn5<>$RR&vq&8IW5kn#o2P<Me@EYA%1@UtoCut`~LIN{9j6IGxL^utnyx!
zk`}KMe?atTzv<u0681OO?=Z|VIFR%G=#8K+hmO}c?q8?BHnui#Npkx(mb3$v&puYv
z=o<e{`l+<Ua9?Rvhu*HM8wKj#Fdg1=UHqGyn}*E~m-rq=x#z#H9q;>gy@j()hV8WY
z=7ZNPWQuH`<ZyooeJ)?9qx+{pKR{D?$+sK+-&|)GT6Czszgw?p`>y3__sfR8I()}p
z9_nvX4$3<AVIj*I{vVIl7JGQs?bE+iRh0LKFFs?&+YF7Sr`>|5#ZO!@6koF1iTjD3
zR%FaOhR@FXL^}1SuPJNXDjX3Z$@5K<A-b0Ff>QbSqmfTvmZWs+AM^clGI)L@-`1Lq
zHH<F>9<N?1Q`&y~r|e=C1N$f5%g!l&ot3(5Lr?aE9D%0lxJ1q7iK$Bt`c5{xmZ$Y7
zh9yv>RqdmyMo`O69jA1uTUV6IKc(6%y#1SJ^KSh!um4*s@t@aCyS=gYwD{(UeGi47
z&&(C9`!uKK$abdB$@_TjaHM{}@iKd(`KtC*mkEbECr7b4bQi0-yOu{dvY5W<D|^h7
zE8_q9>#k@=ubqA$_#4`smS5EKcb=NF^X?ZWWi$81Z97cw7tMLJeD%rqA6e%q+xP}P
zQy08{v@*U$^issWKZmbO|8I2jr+D?`!>;cQwwGM<<a$_e{G3#SY)ztmXiMDwip=)`
zZZho}U*fmkC^>k0i>B9YlPRC(x=0;;p<L<wn6tl#e?{coU7K$BzK}YialBQf;;U<m
z=!Qo>CGYn6+v?8|_pZFQ`TQQC6@D^TBtBhNc~mLE{>x8{;mnKfr`-j$3kp|BJ^NK+
zYASj7E3-1Me$IDS8yAkb9bZBZ_j*iGYUkW^YU1@*wQO;vo)gTj%I@8}YnRoI@98gh
z3ko{yS$?oYfm2w>{D8wVm)IBX4+Wn4y{h>*rHAF1v;VzgpSL}JezbE>?%~4!4`-h~
zR~xV8o-<R{>zu5sP5NVp?!>dtyPtMXInZ6;xoh!S<x5$Qr`o8!jjnBM>zPpF8FeIY
znzH`i@Pl4zlXvFbnJ&7>@izBn-Jq6$y*DSaSUZ;7t(n?sP`>2s?UO0Hv?gUsc6pR!
zYO93x#j!q~>7#x#w_Py&o$imM(@(<-Qk2VoseHP?K388_Vc(g=qnB=!+noGpoO#0D
z{paJ&h4BoNe<uA@GV{A<F{N<L#Z|XTKBUWvs=xE^nUiMLug|dN3Wst_hM}5AT4vt=
zrKj!cZMv4foErV>%2BmWxqn=lv+9H1oa*onX<%gdT~gb_y5Q_1-K%Hn-zLTXo>=9w
zASw29>jCKvfk9Ub<-hEEa?QEsB12dPtKK=TiON>T&MdL)nqzByFlJxGXYsJZb;8GD
zHb1@ibJFeoNBZ~1M|`{cS^W9}vCxyH-@j<C>X=Y;Bk~VV@k=+4brZEGxE<lxotJ0l
z<dM7K^y`xXDruVECD+O)#4gtgn(&PKy}_rfGb%<`uC}k7XTSdOp8by=G;c2PTRQWC
zVq4bC?=OS?>c*d8z0IAxM7-_%^t_GM%xBzI=xe;W9$d1z<5iJo?~Y)BPx__Irjmtq
z`UZz=ol0w!zijIGt)=%{X{%++t+?71uUQn&iYv8F47q1Ed-Ls8++P!asQ<S14r1D=
z^JTt%jo>B4xB8p%qvCbqU&M9=u6-YQ=XU<jLXU)Pznp3wOjDeGB_Mxawq)G7F2;|n
zik2sg4s|N33-5V){P;GOs`v!`o(a`I52zhE&ArcJmG1HvSN><Rp4cI9@}t?InJaGB
zSK2deP}p*=o%PcFn!RT~wbs~wy8p*K+3bN;_tew-wk3K_s_fp8d;cBx!3Et~zjsT{
zDAQIh(O-8#c%k6LLKhtgow={y&YNd8{kZtHg=g#*u=|znvj~^FDDvy@pD!s+40eyY
zuO(;CSneElaL><^)AV^%QrEDUChiM}Uu69=$S&s5mW|JuW^C2=*qaira#}&8$S^0^
z@l^Qqe}WxbZ{K`cBk^%s^i;27ajV(ldl-zDneWIwQFlRn?S4-G&8-JMJ>^gP+Inuq
z##wLVKYxC{ai6@n>y3lcqkrG(`ccp{!8-4aOU=UxyO}pHnVF%h$CNQYYNEZGYv(k{
zh>0wFkBaL`_H60i{hO)f?8#Is%QYX5_8eN_GUL)}gFh+-U7M%I*8JRM=kcYuq-oQq
z;>cY!Vmz03_E~@Vs&%8gJgxhvTl|4gmlN-eem&wU-2H>;dF3pD&BcEWHF!DiCnT2|
z*@ZG~{>^mjN0MLSlh->9wiOzQ?M|_O!o8zQMto||+i&Zdo@7`3wVD;WOq-?am0t_r
z<%3;E)_qWI+_5d?O?=n8C)~OB=giOX`M=yz`uAqpx!H`@ek8f+bsFs5X|T^nOx{TT
z^U-MaeI3Wxs+}u?7nYaHbDdswD6qq{-BFNd-xa}f4MR4Q__7uD)A--KIlY}T|M#QY
z0)bCo@`*-#77zZ-WXhVJ?<H7g*7&pQDq~Gf4QH-&yadDU7i+&rz5JbFyIQN`@snu%
zH5GE*@BZ1OJ?WhH&*;adpFh`Lh>}+L@#E%C<1W*EfBGY9H=4_J8Z@pn*x7B{l5hWn
zTRCUe{*2q23<oxqg{Mu}lXbd;)iG+``|X0Oq<=U1F};0ux?r{bvB#%x{W;R{^mLE?
zpS_*6j4Q>u9_}<qsrw_VZT>+p{z2X2UlOj{!w)rG;Ze@&yeFP`WUbb`gYQ!RtL!s4
z*R)P%4dX@U+w;#F*Ke$0RIUz8>JI8Nd-FVG#vRv~ql)6(r}rG5zPtCg{-o=#r%s#o
zz|S>f%M<R~Aro&Id@EkM=lJyEW_{`T_kXM^4zApEv*yI7r|UcQm;L!SeO=GS-&*&w
zzD7UV&Y_!obN`_qR|Lex%fByGzZ`6!ZRRd$CAuI?=hu2(PrbY&uCWU~v$7@ba@Zy_
zOLNiPnnvzdr$3j)Z{f5*d+AQQ@6#Fm(aSy_{p6~3?2C=vF$1q^X8zU?yV4ll8yxBD
z1dc5^_~Ea<_3uYqg&Ngo_2O+^j<8(2=Q5{g`<)lQ1u-X9e{U6hsh)Lu-<_53KdNru
zzghpnCyNz=su9t4%_T|m{urJX|9I_f*>v%L1rq6#*Dkkt|A2EdbI|0!jXfJ<uC<G?
zZ&<C*Qxe+Z<gIz)(A+MI{oEO1s^uDb?{7*Un;uyw?bInPCdM=~O5*JcZtHof8{X{O
z@9!qils?tqK+FU;yY;FuQTt{%NKEfr(sj6cX;bfYacTY7q8&CD+Py$k{yhO(-^fUt
z?MkJa*Qe{JFYb@6&o=K!T%P}V`p+lsGMXGyXA5zE*k$%$7kBZ^59{{%beA65R#T_D
z`2W@)?kV?oPI<upM(6&eXP4{dJng=z_Ggm(>XgVciI)#oN0l4OoZ7H~;WJ;n#Exan
z4u6BJ#dm&pY6)-?x^U55G1ok5IYYr@ha(GD>VN6EvG&BJYu7)YDB3Od-Kfm^^(vFU
zTI%=T?ub8GxA^eU=vwdD`WreYIXp^hm;T{dx?g{TLA&U$<XPwUN5tIx^tAr$^tpdJ
z_%qf$HL{%lc?!qnM%n9=dpUY_Iwv}_Pygt(RA^6jaQ&3YH-FaVPuWvA|6Yaa24R)!
z4-VM=eKg~ziu}pNaZ4`=t~Aisa?eg~@r#R#Ta?OL_;6izc>FTy389Jayx(Oo@62?+
zus%pXr$#SGw(tD!DW5-XkeV4+>M~FA*eBM1m*?!;us!0O&CRe0)kXJ`VtNku|2ouh
zHnLX2)O$f`?1kHWcFa>(IK4S3c6)i|Ax{nO`)<|-=gSn|KgrqVlkW2%OC<EjS;wN?
z$2+WlF)h84RQs>@%==$2EvK(Ej4yJZY?E3v<+oAsih^?y`vlIs<n~Z}lYeo!p|U%F
z$c&==r6LoaS-fMNarVxZuV0TlnQ}gpP4T<i5$#gA|LWz2C9_+C_b;=TRS2%u+!g8?
z_@pSKM3*sR-vloY>DQmdJsj*DYERbRbW6M@$nkvN%fhs-Fx$fqPx!88e8D)qz2=fs
zyboi=>57n3x5Ew!CtfmKV|GL|%E4Gf>)ydI+4b(O+j}@R?fxh9g()M~=Z{_#-|3D;
zyG~!+-MC=uw_B-~7O8wou-p6b*!s!WPsSZ(W!U^DWxq%I^H!%s4WrjPH3a50HU@3o
z(7XI+EPql$gvZktRS$VSz0wGh{Vr)B_0z%bXF{)j8iP?@P1G!%PN#+cpPie-D{6l!
zU4ywP>`n#qfu`&UIYN_|^>y?u7%waKPI<6E`PFsdBV3s)c~ykIZZlXmRd@MQ#vNw0
zngKI-GXxKnN$?i1eQQtO_n719jq<XOYxNn{{AWx%AQc}|`e*O{9|`{2mzM^u{3GZu
zf2qdlgW%%qggTiU5%cGp1@)}GELLPH+<!T8zo9t8-9z(t73gs+DsEGFk+a?4Wlem>
zW0%z*%<3N&ALqaC^|#Lc!`p=h8$a4T=Xf05`O~IlqRw^R)g?Iru3q92-REWF|MeP5
zeq&y9Onyu5sY30061DmB=a{jrZCHQn)iHy+MgMIcaIN*YBjTTSe3m^o_vBwp<}&Zt
zKK=2T{y1pQ+6R&=?qxU%Jal2T+rDT)&xM5?zq(KAJgTei*VTz%qU5)wCOG~_&4Z|8
z5<8v$B}pXqoDPrFxxe9z`a;#bQ@(!-XYRG~J@kjS&XD`G_y+w?-pXRx=h!6Nw}u`&
z_0l1wVItezN6N<{cK&hg{yRld|MnC?uJXNaY}T{wIeTPJ-p~0G+^5AAXI?XO+VN)Y
zxr86f8=GFgY&LoN;DL$Y;T?M<ZhbwJ-qWzfVSkj*^(x6j4~%4kGS$+LU3zMM;FGIX
zGV@C@UEwDSS`*Da&e&4lbpL^D>hhb6Hw_fEFJJ%kGJkP*tLZ+I{d$4Nyxz}Trs@`T
z-;l31_PG4z`Nfl)rr4BZUp+hVk=>ilX?oN2=NH%A->3e#<-3ymYa5=Bm@k_)OgsOp
z_vnw*Dv?#fUHUIi?>J#Jzx!x?K>WWsKa%VgNFTmGH{HzYK+Mq(5C0!8joQGh>?P8;
z?@x(N{J)EP_IapF$ouR!d3oli?Bn&>ts6INs9E?l>_hV8x}`@iwqEc5xX^Uwwhc9r
z{5*#)bN%J3Gg@{?gk2{&G4banwjI;bS&#qxbK|RR+h)^=H_ucr|NpsQ!I}H}*DC3J
z`}*zD2hO*j_&-h*<!&&Yt{d;ec}DAtc+Q`c7d9P<OW9{Xjx|4ME56w{NK@d2Fnctk
zQ+&da1OJM<HP5d0`I6@@S@Cwq?Fln9XF9h1(M@A(-oY(lcrQ^S>FvK)?c2T`J-0@=
z_wL)tQnBI^vVu+Fk{fCal`n*BnDeGOqw=3hdw1LoiC9a`>B7@D6u*C5V<%dfwNd<w
z&7Sj`wo5<#WMA>@^JLF|Hze0zzdScQ-e}?V_wJMU4u2P7zUN%7bn%^|S|L;L#=HOC
z_5Wa+yTUrq{tolst3CzoH9-Zg-Nl9rie9$vY*PN-V7giV|B)F{5=*ar^3^j+)p>vL
z*^B?l*L&vQKC;o`-|{;v`jho~CQTHP+T7A8z}Kg<Lsw=8n}+U=W2FhXlYNbL{{N@)
zX35*TCFRTP(>@=Q^YnlJyW-Oe;{^xXwnm@Hc4*LiwlE@aLzAJ?9zi>kQ?C9uzfa50
zdlw(CxAf`k{_EGjpZfXq`0vmDFD`$5`}Fr~Yt{MFsx6QC?{RqTI*)t7tcmvDO@!38
z6+F(}^l+n%P@~hw7fz3welQ3wxVX9}?n{VB)0NA==G+wFGv&5)@?FHt^dNQ($Hjeh
z0-v3#B95LoU1u6#Q2r%RqEhg>?G&S|DaTJf&#nKx`g2o4Y1x<W@1D%t|Kz`IyM5nL
z=I9ef3K`tH3mT=07YFyU9bUCU^#8$kR}35Xtz`=Tl2BP$_vhvI=*-GWU2lf?I9=7w
z(@S^X-{%qZdQNEZB~y{-Y=QEXC-=&pW;_ycOYLo=_}$HIuCgy)2YEGTT`;_IaMgzA
z-HPAbBQtJ%oYN%z!gXr!tx}enxJ3_+y4^Sz^yd7kMXW1$cdv-f)mr3L9mclK=Kj>%
zQtR2Q)g4YJzWDxN-CKo6d)B0dPH>v<``GeJ^u*@Rmv{?36?xwzwlbct6#Xr~v{gKA
z-cHAS*}tFdwd$*XHazrqdajcd#Ii2aJZ<T!nbS*EzQsJ6v1*=ZtXP8FQWLl5H(8GT
zK0V!Ee*L>APiJ4AeY^O}>7%!A$BVQyd}cDZcy5kSkBQUjHFh7Eu9V%;ST;v|bKY4E
zn-7~l=~NqfZd$=3yMD!un0XO1-x{9vI}`Qd)}qdtdf)Fz8_HhGQC5(wTzSa#*@VzX
zA~VAtZ@n(5`TS^R#<@48W^en`b-G{MaPzF6ShCHGrBT4@<gIOI0&YsSi3i)yzNPx)
zpk8svo_SfVC&NCa+`Vzq>D%PB3!PWp?0www;n3;N20tcx=9ZPD{C%v!{r}5-gNk*A
z#fs7=SD8lm+vFdT-1IE>(!*1CeBR{T*_|?Jwx@R0>G1II>G2}}Y|2Ut3!5+geR+HJ
z(?)TX_vdONP2J-TxyQxi&%PCRs&eBQo!N&Q#m}sqqShJaoHsQ{%Cf{rwxBL;LBcI>
zr3K%(v(Mg~|By9be2w?suNCi3%$VtFx8F_c>{_<l^ZXggrs)Y@4hb}jmC0Yu%Xc=*
z=%UH2XtxuoNs-no7Hi0aKi>K2Oc7&7v{g>ywP||(Hx_8D+_#NqrHIsxjg_|z|F%wl
zp2+og;lnG>{y+S`^|<|vw)`2v#bS>uW)*(!e6GRqDrehgwZxRvnah_pG>Ak_-PpOs
ze*c{KJ&&LNJ^hr^_TjI|ySuy37d%)hSy{O6sjHUm`7diG{kC0Pa`FF%AO^0Av@G{T
zYu&!DoBu?pIC6;1ii|XVF;j8-Ngm<jCuj02>j#D}6L1rqsJ14cYBI0s^P|&a_1%ip
zD>la1CG4qdzhY=yy)mfyr%<6%X^iisQ#KxpVxP^J)_-ly)Watf_hnjzF+4orBcH!q
z?)-+ThfgCV%(mDYe7?ST@n(77Tbc`+19=jcTvU2_)nLi02dtW}eY!O-noR#~;B@H_
z*NL(xtVeb}J^gg<ndm~6<LWP-{Jpw=|6^BU=c|=ZSU)^?T6I{?Kt5RVU%$AD>9v?Q
zp;kZp#8W+P@%}!={iJhQtFrz)ULl6UMZYRiO@+9uS5GXz<`txDeB@~3bd$}&ar>E$
zeAf!}%rl+fHt|+8Tct#0=F@4m6C6Gy>Gs`Dc`#?UEw{j;x@Q*@K2|by&1>HK!D;W}
z`CIQ-zvSGdxFM2#@AD^>o!|F3oL?i<kpF4V$I1y?5(|Hp)bE`3UN3*i)79nc<Lmzv
z)K>le_4c<g%k$~|=aVaPd5x!C%`*A)sLF6!=i{ZTGADhMIJnAIpYwUEsEtxr8T09<
zw)(u!UB&m<Y^bq)x+kLXj?ua9*}l9E%KD;Wx#u3mitOAmr(DNA&R15pe2tdPx$cT9
zhZv)u@9w?w{PUS*izc1XPSOq%zcwL#&D7m1_ZA8-7x_N@?UpR9ZHJ~#KfjDo=Tm6N
z!_MWVm7Wh;r$0~dTK#{`SO02;=YCJ#a3t*QI>Rt|p}?LMw=Gx}^onIZ?Ra*sh9hTs
z_k%xQ;(q=4$2NEW<Fa25-+g%$zkNRA!R42;9WI@k>2cxM#cj7&rNjp4-3ZZkm=Hd>
zP-oKd$J@epEo3u4=jtJ2smgl&<kQ~8@~_XiJ-T<TtZ7GcXRKG|p2H2RmxwxX$oEVX
zKb75Y?!bJOGlXM%U_)jct8uonc_{CKvZyC7HWY11Y}%n&o62@<)`fF(SPQjw7EXB_
z)6HDnJZo)Ymg=*spSqtdu#Vc}xMI8V=8A_;XG)x~&laj#+Sm4bx`>Gim;5JvD-#A4
zmB#`C2N%e&v}d|XIQ?LDHTbpv)rzi%n%9GmZTvp>xo3kbZ_<ZcnSevP{o}0sx&Fj5
zF)T__4CZ8FiCF58C3Gv2%l|94(@Tl1`aX=Tjho_mJC-Utxz4W-VLIgA@?!y`%&JrM
zH@7BFWouGkI2_2LtfAf^u<l|aAGdYx6a}+NR_oO_j(uP6`a$4`fu%>+lYQ$WckE3|
ztY3E1BIoUfxD$0}zgAB)bUEe_S$Fp5<D{AY|4+2{F8O@@=;zz3_CMM$z4uS?ldtY)
zZ0o|8iGRur-Cut4>G9vEpF8)=joWd)C#bAE_Sn3O+%H(aFjZwPV%y?A`y104xBCzQ
z#=Q-34*Hu{FrIx;4Ph@3zrg)sX|EKR2I&C_=PhP4x%@sZZxLHe-hS~5+!LCs7(b_O
z3e<Oaw@%z3{y<IUBDR?MGV}eGg{KEH>Ydwv<j9c&2M%c{pX?Ox0Zq=bh`LD3ydfzu
zBf?@w<VVOft-OPb&VxUPjvPAFC=XVoaI>{>?%d8!R(lE7#R(z|$BrC1$H4aHjZeiv
j4GGr84RdAZ#4@O^wUb${QZt2tfq}u()z4*}Q$iB}o>xQ$

literal 0
HcmV?d00001

diff --git a/index.rst b/index.rst
index 23b0de321..c3fbe2bcb 100644
--- a/index.rst
+++ b/index.rst
@@ -1,12 +1,49 @@
-.. PostgREST documentation master file, created by
-   sphinx-quickstart on Sun Oct  9 16:53:00 2016.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
-Welcome to PostgREST's documentation!
-=====================================
-
-Contents:
+.. image:: _static/logo.png
 
 .. toctree::
    :maxdepth: 2
+
+.. toctree::
+   :caption: What is PostgREST?
+
+   intro.rst
+
+.. Installation
+..   Binary Release
+..   Build from Source
+..   Docker
+.. API
+..   Tables and Views
+..     Filtering
+..     Ordering
+..     Limits and Pagination
+..     Counting
+..     Response Format
+..     Singular or Plural
+..   OpenAPI Support
+..   Resource Embedding
+..   Query Limitations
+..   Stored Procedures
+..   Insertions / Updates
+..     Getting Results
+..     Bulk Insert
+..   Deletions
+.. Authentication
+..   Overview of Role System
+..   JSON Web Tokens
+..     Internal Generation
+..     External Generation
+..   SSL
+..   Custom Validation
+..   Schema Isolation
+..   User Management
+..     Logins
+..     Password Reset
+.. Administration
+..   Block full-table operations
+..   Alternate URL structure
+..   API Versioning
+..   HTTP Caching
+..   Database Caching
+..   Debugging
+..     (viewing db logs)
diff --git a/intro.rst b/intro.rst
new file mode 100644
index 000000000..4d070f6fc
--- /dev/null
+++ b/intro.rst
@@ -0,0 +1,92 @@
+Motivation
+##########
+
+PostgREST is a standalone web server that turns your PostgreSQL database directly into a RESTful API. The structural constraints and permissions in the database determine the API endpoints and operations.
+
+Using PostgREST is an alternative to manual CRUD programming. Custom API servers suffer problems. Writing business logic often duplicates, ignores or hobbles database structure. Object-relational mapping is a leaky abstraction leading to slow imperative code. The PostgREST philosophy establishes a single declarative source of truth: the data itself.
+
+Declarative Programming
+-----------------------
+
+It's easier to ask PostgreSQL to join data for you and let its query planner figure out the details than to loop through rows yourself. It's easier to assign permissions to db objects than to add guards in controllers. (This is especially true for cascading permissions in data dependencies.) It's easier set constraints than to litter code with sanity checks.
+
+Leakproof Abstraction
+---------------------
+
+There is no ORM involved. Creating new views happens in SQL with known performance implications. A database administrator can now create an API from scratch with no custom programming.
+
+Embracing the Relational Model
+------------------------------
+
+In 1970 E. F. Codd criticized the then-dominant hierarchical model of databases in his article A Relational Model of Data for Large Shared Data Banks. Reading the article reveals a striking similarity between hierarchical databases and nested http routes. With PostgREST we attempt to use flexible filtering and embedding rather than nested routes.
+
+One Thing Well
+--------------
+
+PostgREST has a focused scope. It works well with other tools like Nginx. This forces you to cleanly separate the data-centric CRUD operations from other concerns. Use a collection of sharp tools rather than building a big ball of mud.
+
+Shared Improvements
+-------------------
+
+As with any open source project, we all gain from features and fixes in the tool. It's more beneficial than improvements locked inextricably within custom codebases.
+
+Ecosystem
+#########
+
+PostgREST has a growing ecosystem of examples, and libraries, experiments, and users. Here is a selection.
+
+Client-Side Libraries
+---------------------
+
+* `hugomrdias/postgrest-url <https://github.com/hugomrdias/postgrest-url>`_ - JS, just for generating query URLs
+* `john-kelly/elm-postgrest <https://github.com/john-kelly/elm-postgrest>`_ - Elm
+* `mithril.postgrest <https://github.com/catarse/mithril.postgrest>`_ - JS, Mithril
+* `thejettdurham/postgrest-sharp-client <https://github.com/thejettdurham/postgrest-sharp-client>`_ - C#, RestSharp
+* `lewisjared/postgrest-request <https://github.com/lewisjared/postgrest-request>`_ - JS, SuperAgent
+* `JarvusInnovations/jarvus-postgrest-apikit <https://github.com/JarvusInnovations/jarvus-postgrest-apikit>`_ - JS, Sencha framework
+* `davidthewatson/postgrest_python_requests_client <https://github.com/davidthewatson/postgrest_python_requests_client>`_ - Python
+* `calebmer/postgrest-client <https://github.com/calebmer/postgrest-client>`_ - JS
+
+Extensions
+----------
+
+* `diogob/postgrest-ws <https://github.com/diogob/postgrest-ws>`_ - expose web sockets for PostgreSQL's LISTEN/NOTIFY
+* `srid/spas <https://github.com/srid/spas>`_ - allow file uploads and basic auth
+* `svmnotn/postgrest-auth <https://github.com/svmnotn/postgrest-auth>`_ - OAuth2-inspired external auth server
+* `nblumoe/postgrest-oauth <https://github.com/nblumoe/postgrest-oauth>`_ - OAuth2 WAI middleware
+
+Example Apps
+------------
+
+* `CodeforAustralia/heritage-near-me <https://github.com/CodeforAustralia/heritage-near-me>`_ - Elm and PostgREST with PostGIS
+* `timwis/handsontable-postgrest <https://github.com/timwis/handsontable-postgrest>`_ - An excel-like database table editor
+* `Recmo/PostgrestSkeleton <https://github.com/Recmo/PostgrestSkeleton>`_ - Docker Compose, PostgREST, Nginx and Auth0
+* `benoror/ember-postgrest-dynamic-ui <https://github.com/benoror/ember-postgrest-dynamic-ui>`_ - generating Ember forms to edit data
+* `ruslantalpa/blogdemo <https://github.com/ruslantalpa/blogdemo>`_ - blog api demo in a vagrant image
+* `timwis/ext-postgrest-crud <https://github.com/timwis/ext-postgrest-crud>`_ - browser-based spreadsheet
+* `srid/chronicle <https://github.com/srid/chronicle>`_ - tracking a tree of personal memories
+* `diogob/elm-workshop <https://github.com/diogob/elm-workshop>`_ - building a simple database query UI
+* `marmelab/ng-admin-postgrest <https://github.com/marmelab/ng-admin-postgrest>`_ - automatic database admin panel
+* `myfreeweb/moneylog <https://github.com/myfreeweb/moneylog>`_ - accounting web app in Polymer + PostgREST
+* `tyrchen/goodfilm <https://github.com/tyrchen/goodfilm>`_ - example film api
+* `begriffs/postgrest-example <https://github.com/begriffs/postgrest-example>`_ - sqitch versioning for API
+
+In Production
+-------------
+
+* `Catarse <https://www.catarse.me/>`_
+* `iAdvize <http://iadvize.com/>`_
+* `Redsmin <https://www.redsmin.com/>`_
+* `Image-charts <https://image-charts.com/>`_
+* `Drip Depot <https://www.dripdepot.com/>`_
+
+Commercial PaaS
+---------------
+
+* `Sub0 <http://graphqlapi.com/>`_ - Automated GraphQL & REST API with built-in caching (powered by PostgREST)
+
+
+Getting Support
+################
+
+The project has a friendly and growing community. Join our `chat room <https://gitter.im/begriffs/postgrest>`_ for discussion and help. You can also report or search for bugs/features on the Github `issues <https://github.com/begriffs/postgrest/issues>`_ page.