From 3115a37c6388a048913337fad9bec88efca3b88a Mon Sep 17 00:00:00 2001
From: Chris Holdgraf <choldgraf@berkeley.edu>
Date: Tue, 26 Nov 2019 15:43:07 -0800
Subject: [PATCH 1/4] updating theme to pandas sphinx

---
 docs/doc-requirements.txt             |   5 ++---
 docs/source/_static/images/logo.png   | Bin 0 -> 13493 bytes
 docs/source/conf.py                   |  11 +++------
 docs/source/configuration/index.rst   |  10 +++++++++
 docs/source/contributing/index.rst    |  12 ++++++++++
 docs/source/getting-started/index.rst |  11 +++++++++
 docs/source/howto/index.rst           |  14 ++++++++++++
 docs/source/index.rst                 |  31 ++++----------------------
 8 files changed, 56 insertions(+), 38 deletions(-)
 create mode 100644 docs/source/_static/images/logo.png
 create mode 100644 docs/source/configuration/index.rst
 create mode 100644 docs/source/contributing/index.rst
 create mode 100644 docs/source/getting-started/index.rst
 create mode 100644 docs/source/howto/index.rst

diff --git a/docs/doc-requirements.txt b/docs/doc-requirements.txt
index 6fbafab2..640bb9cd 100644
--- a/docs/doc-requirements.txt
+++ b/docs/doc-requirements.txt
@@ -1,7 +1,6 @@
-# Note that there is also a Pipfile for this project if you are updating this 
+# Note that there is also a Pipfile for this project if you are updating this
 # file do not forget to update the Pipfile accordingly
 sphinx>=1.4, !=1.5.4
 recommonmark
-alabaster
-alabaster_jupyterhub
 sphinxcontrib-autoprogram
+git+https://github.com/pandas-dev/pandas-sphinx-theme.git@master
diff --git a/docs/source/_static/images/logo.png b/docs/source/_static/images/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..9e03007d007cb9af935f0a5042cc448826843d44
GIT binary patch
literal 13493
zcmeIZ<zG}^*f%;L3WAhUN`pv)ba$wrbjKhiC7r`i(jlc%A|NOsDV;-zNXpP1Lk>s{
zIRgyLv-#ck^EvO%KXA^AVY6q}TKnp?uIu{lI32BLq{NSiK_C$6i|49(AP{~C@c$^$
z9pJCt?G7*Ca@XUzsW%8j!*TP$d!hFj1p={vUZ^S=1bo?BB=Ipk%@IT`_eVrVKEuby
zKO#olQcHbZMp#zjk<ha_^CKqE!7!>-earjb5R7JiQpU#Jn53{w#bw?%zn0i&8m3V<
z{Tn&qIGOHaFy>rbAYv1#m+BvI8~-t<|CQgh%<h+67!G$Od%1gcRc`J3Qfqh?>VOPw
zN8&J7`Y;%b0H6?bXdJ#Q1Y8w`Sul9O^)W#>^UbaD|Hp4Xt<dgSwy>J3sG=!G@el1}
z;v9oryw|dOg1~@yC<K2jErGEbmcj(`*Aipvrc7)FlNEmxWfE2+fuC8XD6kefL_y~i
zAV8*H5foSk4@%4tD+nKuY!?fLTSLMw!_$$yfLmUc5uXK^5lPmitt^E~`=p01@tiQ%
z)39f}<nldxKQPYz-y}y0ET1HCkeF?W!#c!lYdnof;XQ~5n3x)l$msP&@G>h~ifrm=
zPZB-47<Mu6I%+z5N*1<3h^E*GGypT<Q2;~nBM_Vcq(Q~SR$9%hX;<XDGMIcC&>-1v
zzCmS-Ml#d)8g@d1TZm*;knC!2^Nlf3gy-Sj3FgIs0zM@uCMb^(g#lk8Ol>0aJ{q>j
zbwATZLmt$1W|TeBDs~vk7tt3euxR#0495INSyXxxBEzk3i6{J%8DcH1#a^YZ)BoRx
z<nb(ST4-P}fg-RL*QehE9X=|4@3vN2!Dllp_*U{{VQB}j7aPpMVgId?9~+EHFhdOX
zmW4JGdh}KLb590G50D*<8{zXRf^JOsnGHR*fa(8Acf^Jk`-Px=VZ?f_AaNlje?sm}
zI1Q!+o=rFW&g{PlVPAhg!AOw>efy(Z>1AREJTe(C#RXJJei{bw%yJYjkLlq@ZLEPz
zn%7>H&YY4JYUOy`2l>Z=nxrOf0p1<f$1{hZMR#Th`ksjz?gwa+yyM7u_G1^p#3SXa
zyzz|kM(K+BK3#%~DLL$$HB!Vu4!zpnDzm)f1yCFG6rg10sX);Gj8Yr@kN;ADf6cR*
zr6bk}OBpTmior7P=9pyToj-T~vkpn>b3{z11NnbyG*A=Au%e`TdBf`W5M-f||A{F=
zRRH)B;&3l)<I-RM-|oXSr0R`yVw?L26pY`wPn`P%4sc9}*^=Ss-IW8SAIz%(76xeB
zT-8S#u<Jo<W<fxf1Z9XW_zT3h4|@M9AAZ|w81=Q5^ZnZt9yrLWEH!MiDGX|7`(M&+
z3SM`SzY`2%0P!w|evIC|*1pkb7y+>yrjWiyj13k1>f$v)yW%HCtj-Qzxg$>Gh84x|
z$VXUJ!R2gK(Xq34L_zsa?{pqTKx4h+cm!J+NPrbU@%l4e2llf`^o!qyr~PInAx@u%
zwKAhSY4ORz4Bc_LJbrCz_Rq*l2s)i^JZ{ZnAB4zz`NS3-JvKHmQAd;^V<wz6M50<Z
z^6%^C&!6?~!bGbLX^!Gdqvb0e58f8pUf*@8ALFB7TKcm;bK0moTR82A_wy)6qU0oi
zuqv-XI@-La0Rj-BqpHE?S;A3h7MK2^Qj13cW6UGvDT+^+CQIFR;eY935QzP0xn(Q%
zqQeLn-NUuZq~P7m#3R#YO#g=AXysCLwXk<<!rn>RZw<+1tQ$qo`+CwH`#IX(b*drs
z79cB3ygF)pBaq8?^V1o#3T{Co?cgd^dWTjI*%n0<hF21R(>Ay~fphy7@%kYF!vjUA
zv0;3JF5F772v`2yhlN^s1=bbXy1wQljCspnqZCm|x0d_TaVmwqWTx`8=%)0&<qFsH
zJD@4ytd}{N3|20gkMovI>OJ*2uNz<S`D}IC-wyi;thrJ8Y%Dc9WBkzP)}$<&q@wdD
zC7~kIb;Z&YElBE9n0Mhb^3knl(=To@<Cp@~lctzRKoN028^dF3R1Jzf;{NsE&Io_K
zd@|03k5IR;0TF3_j}DZ2%g}NKepGX*P$%VZj+b&v^RIVy-2vnIgqO6)c0o9!i_l7^
z@$pc{ND8^X3DarT3)-=2diUa5TTYHEFFcb0J7I<equI0$k1!Qm@sIte<BGS=&dyzF
zgkfLRT$1uS-zD8*fgi5rwqu!it`A0&uN6sn7jDIZ94psPUX(g5DN@Tcn#<prrcf04
z*zb|N_$Uu>^?jir){p(=uFlRa<Q-%nBE82Ed6h1kX>$s>m%XqcfKDjEDJWol6IXOf
zr)-6wKU}pHJ;@1WAJ}+V^&B2Mx+Qj7hb3@*D$=9ED2{bKEfYrwQi}6IjUTp&T=%Xd
z(*~lxD6o@-*-9))ybdwbJ1j^nZ3I`724!;IWy$Eb3#k4>5`7M_?u(x`iMOHz5#)1)
z=V_VG%DCq@^mX%ryx=Ujo$`)2ts(d426yQyXqFE?b4>>SIk|*Ut88y2HnOAeO3Hlc
zE>5Uh_oAyN<3hEfW9uQIuU@@!Ic&uTbx<3kY#BCBKz+x!BhAjA{~Bn2Xpn>*R^geP
z@9!8KV+HvW1icX|{Hh=%;2m=!Swrg8fzt!()xwRsXZTq!pYY~tau8JZ+X-XaTrrb)
zVR`Wam~F}5TO6;W8^t**?|d~%IEZ@oJGUi*6@`cS#fLd$W<>vS^%17kj_d}O2}sz|
zt?ND}rd^pP0)@o?0mGP3K|ok1Jh<R=O?@U0yMve^MQ5Fn(PY=$3Y{FbpQvK0yB93`
z1&XM=tnW-1Aw=YEd5WZ)uAsz|W2_eiIw|bUixRA@Wk}SX6M#^!M$a%CYnD%%z&U9)
zRd{_!@qhh!&Pb=*3FaXDYNMgkR(O@oAj2boGmYwi-<3$gY+6}7kSzBF!ohH-s;%uy
zAQbwewH4YqoltS-t24hmXHUkt6y)7K@~FJ$p=PaQpw~&zEg*)lbs*;tk3IL~U;LmW
z3*kL1!vl3txuR<47QdC(eR}fhiy|#p@?+(5E6qzXhJxZpjUy`&ghwIrb7G+SPW0}R
z(f}NP!4i19x9M(`EYfpk>J87f^pD%N?Ma~5f}LtK^gUWEMzD~2*@Xm4IZ&sd8ZCAg
ze>w8FcXXov<JLd5yzecV4*JGPC1-2}36++Lg7Vc-4f42qzB#g4=%CRuJW1@N)#y)&
z>&fZW!9Tg9`?U_+opqW{Cxq^o0TUp^C%PloPvs1iy&i%fOrc|Vo(3ZOs=93Z!v$o*
z68wU3QT0zqO}2dNr_JTI$Od`zdneF@3+QOXA>Zhi7h;Wd#sF?Qe$dL@J|q`Yk2@%y
z^WE9rFY31C9KRl{Dy%hRr@(>=^40ERL7<=q=LqCu)W!hsHY`WRsrRhW>9S#ZJHo#~
z|1ZS0<htdy8LF(jbe}v-8|Ni*wbCd^9w-MRc$rzK(?qk}XQiOb0lEFd7aT8mY(vrR
z#|Z?acGKyRej!?n_Xz6)u@Rd1C30Kc#Y-%g53iq7U%XB0h08j5$94~7UUjeG`IO0n
z%K-sVD)M24jOV#AzdS!m?)#}!uZveU8h=$eOW4KG#@~MOj)FJlxC&OuUiH-1_EY1>
zgh9E-4g2O?NtRZ#IUT>u6_S(MykB7bLOmVf5kc^Tx2QG4@;9gFbcF2>$BW2_f^uN0
zugF~srjU7zs2O%b@{xoN=kEjmoIiI2#GQ$eg*67R44M(Gvm&q{$8tQnbvIfw1aw=7
zXIu8oMX-X)VGf<uGtOSEf{795f+dF2T<ISu{c9l7ZGNP_yxw}blNOg9`f4dV)&2Le
z1F5<F>?jUYyE-%1Lto?W9xXl{8*^J<T)~((Fwuz1g17c~W~)vhhxs@C0<j7^zlbB}
zdmsisNm3Zg{~d3#PWjK}QRO9Zf2oaJz}7T0g6{JYT^c0DvpGig3*p0gK~I6iC=3*c
ztac4tbybNWySkRDdyuZBW3KovxBx0q#$EJpCit0mr4~6+ket+5Am&IVZ`3`{X`ei#
zWlqSp4kU@bXqO6GP;vZ?rz42BhP-aDNN}I{sPJu!o$zJHfhg+GWB;iu^BQga=jb=R
zro!LDHPn+iG}3h3k)Bq=?9bWy-s)g)`Mo^xDnD!@cgc}dU$Vf-r!CUsOOnf>W-IQc
z{dk}NM^=l!ulV&ldx0k}T5_l7!1|R*uT}Z)s~QcgH!p8P+VRHUxr(L*l>&aV4G(h#
znZU0r-VY7?P(ZLXm_vzIp>-MNj=wG+zh`@ZwR`7&^gB*;XQ0^!a$&~9EMKF5s!qB^
zxYffse3djXFt~kIwV*QJ2pe6__TNQW4^CIMuIrUvPTiWg9-c44(*fd*Tv)Fg_RG%w
zrwkb9ysN0Hdd!9KcD(g!%{RhV%o#k)1ySub6ziK9dD!8`+8tXG_k+oa2`aN~Qlawt
zo?h+f`qjVT^rMAJFl&^2-G{Vtx9#2zWd?-?84-$(X;S$mK~r73IkcXHuxC?@s(Ia$
z&hwnxjAzu-I(}|J!L-eC!%cNarFLXioGOa`Y|h)jx@Lq$0cDs(_kz<~l~Wb5BR%_r
ze+rRr!49s!*wPMBU37q-gr*@c`nT{<<W=o2`L*AUM#m)%pbz{EZ;do{{)!*(l=vEA
z?JmfeEg7M{3$faE_{JAGLc7j9O&pR~R8&-mCl{(PT2grzk(jIs?<TQ$Jp-4J_q=Mv
z%+y*((eJyi>O<F|xZl3jYmn!L3xf2r%)77aSIyug?AV?Sru*Fxdi;yaN$R&;OCBM9
zSfXIH<=hy?3$F5;1YwF|RL*D_P9FTt#ihjUXkF>ufur^^`m__>ip(t<FFv_V$-Rd=
z`RxB^#8}9OYw<AI%2<A>d76LZ+Vr*}?9S`y_flpnc4a?{%o5-)4(<0JRzUV?gIQ}D
zGm_qCYd{5IpQBHFXjM=yja#lymr&r=omX)Rm1suMy7R<0*WdklWeFNsW3}TKx;Zx^
zZl6AJGZ6f>?4uA!`upcX`cry|QEz?PH-hDw@4z2Z_G#OVH*cTg174(j5uB1KK`SkE
zpHh8`H~OsY^#Q~WpFCtcdRLgu?3Jp%T{5FokmRde$#<LJ;6x{cEyEvh09IEz@cHr&
zb~V@!szOPVji|Ef2ZCQ8)(RG1?6`eB)Gv~j_ah6f-L$kf#V_*e&7M=JU1~|iT~HWa
zT^d;>2-cP=xKAoCAL>4E#0~LouWudBO~-uUikI3m3MH6huA+-S3ZCgk#c51E-y&gn
z2^F}<yJz&`5$W~!nf;pLuPS;&jbLket8dn6d6inS?o&$a`n*dcmJ%bPsEabuy1iA5
z`A~G}JzgC{n(CC^Wi=DK4)SR^CjsT?S(wTy-OleTTffkMa-Q#E2jxEX+f7L_q`##_
zT3d9Lm5E_31&3ObrHO?mm8vWDP(O;R=;n^Y+mQVPG}r}#b`pob1!Zm~&%1lyi;)IJ
z1TO0ZCot&4ki?AetKaw)79>>*8$I;0xPu7)i-A@TOt#p8ZPIYJ3BG#a9hOrcO_xK+
zB5%{>(8D=}tE1}?TK1Yd)uZdAFADE<-|5eG$<Bn^URtbPn%S~#(#_s}y3g(Cqx+=b
z?;E<ZsW$;7D&@~VR;-)vc<8k;iCPA)`l6y2^J{1;O<v5g4ckU3e|xp+Ke{q4--`E>
zG{nsq&J*&Sr3YH9CW{PSZ5PV6qJ3VaX0gxO?egO%DL)OoD)gthVXXDiQ{_CJmwU}G
zbq*j6_;+uV|Awta^Gwnfv9>q)$Kq+0v>M{laazl@TFuy@_^jg=jYVvy!|tnW!%%Ae
zX4__(v*!doiMYWTk(n6e#o|>3;RSQC26>owRclur!M(UgVMYs7Rt;l=N)m?3KT56J
zK12m3Q-{tzIqdJ{Lpdfk&vTrulFzxNeJZ=#hTTqHCVC9x#>$OzTnd=-ANtp|=!t@P
zAxAaJ>>8^N+`kQiYBW~P%@_EdtVmc_*BIDyFi0%$Q<hH~@k;p#cKh;p_kCJ=?7Qk;
zH|23a(2g%ehEB1zPJEewG55nhT3tA0d0@g#L0{9LN*)Xj{AoL$OL&@F{0n{K$O0)*
z?f**i=NRMx=9${hV1!#)F%qL^4H844Ptyv(8l+n**?#?e{3(aO?lH!+_ex+VPPm(T
zJ$8<@$NByF{Cz_L@6we$3OjEDIMy>W(kc}D#%(C~Woy@|h7W6GF(iK;kVB})d9J$Q
zG?^YSUQ&Ply=ep)Z1ne$_w+}2Pf(Xy{DXw%(d_;8b5eVr-GD1b6s+3dQ{vB^u5wbA
z*h?iE@rARqACZNLtJj`b^ai2@dOrr*r&FZzr!nfWb!ew9*Zk_Utps!E{v|ZGl;t0k
z@8^ZOz1r=+<=Gkuw1P#u%N1XvG;!&roG*)#m<n=a{Kt|z4wv~=tlVGxAPT-^tF;HQ
zby8l!$}!!aN+W+*@b{Qryru}}G7k>vU*pat2@6G6OqyXBeA=j0>hqVcc&8<agWL4`
zf$VA&<LmEIXg2ieQ+n>s>HB1?wmjC!A-7in)apgPx2m7US&-l0G8Dc`d5BeKtvq0h
zg4p@mlnmUReQKL+^>MT3xbM+=6x(yvxJ7!?m~18ml{gX^S2vZs)TVtU0k+s~x$nXm
z9`@B!c?JNNQYUvkUEmP`aQ*vc))GsuwoBBt+pC&yMkn(u#+Wf$2@Jh32c*%~8EOAf
zkenq?#+p6DoH7~NyFk<mQ=|Jb>^;-@3VIv4+?>}QjJCYBiI?<9BB^MoEtaQjm|9tW
zd~#zR;;GF}&WIFbTIuXnX)Tp;JE@pj{9ZvLFn>z6;U#A<Mt!~ih;nq(Pb+I!=k{`Z
zUX;V$qc7CN8`2AoC)NInJBNMQl5T+lrEu=0dv@LOAsH`pqzDyuf+1{`sg^7rG863c
ziQl@B(uus(m94fn`=!idk}4N=S=>ar%`6SvKL7qmE;I!0%@&Jj9N$fVp6!1_&nbMJ
zwt^;JBNec6a+esI3ciFS<l)1^>lQ{rG=2M6qjN?KM2g_-h>R*a{P%)>-!bTt799J!
z$sO%hF}&QBe0HKB4#ViT=hX?B2v2tQa##g8q#QE^hVkHnd2@KGzF&P5D6-JjS}C?2
z^wy62p6Yn$-O7Dv;itkIg1+#@EIyCTXEjYJrzN>#&^HXJSnk%nz>4&D(@0CkbaI^y
zG?SjygzfLt(@rmXyC=j+E~t#<P6N9zOQj`(YOtaF#EI~|WFvBY9GY9h62AOV^(1{(
z;*3%D`_-DqAM4#qtIH4K%*m?TRP5L7o=Sv-yku`JJ|?TY=9y*>1ZiF<=hB?$A+JLd
zgn8PC>{c9ZRaKQmk|-z7dgL`6tE007=FI)2_DoJ7|Gpp`c?=gY^@Jsh%nlSPJbsDU
z%SyJc6p4{rN}ph<8uW7A>gPZmuBsq_EI&j0r{ta1C3)j~bqi=Kl5~A8fr)on*@R)A
zH7ZJm>WyG>9+few@}!zmWOxs<bqT&~Z~9i>d>Ctj=)yw<w)T2~*45}No@}&4n>(#<
zP2Z{b#UZpicsmm!>3h9uzI8~duuT%Ra4WN;F5e#k-%gPK_r|hxa(!*GS+}dz9cAPa
z^Gy3Y>{LQm8=_{HR1qdCL1jahG?{G$RSdQBQ+XIN%)5hHdo*jpdrnp5B~a5#AXi?m
zE8J!@0tq3uH!=v!DentcPnmA->D6HbqC)AWHO_@<ts&exraiL}N%adR`<!LNLK1t(
zmh7W)X2fPDShj&4welOYRWPkO{ZpvW969WhlfBdHi++EM4AAXaw6U_R{M&19)nvpB
z-=SB4@E95yJ6XHWm1`1~pCr~KZD;6L)|6JsYHDliGI%S_1vwM#T|bTZ9P2i%qQlv6
zefTY-k^{l|PW=T+|GbWugjwl;YlI6jUODcsbQdFeN9e88n_kUiH`XdxUY8&cs`*%`
z>>Nm$`vw{?v*XW%+~HS&aPP-kIWo>vOykMO?L!5ov5ggz)+H%dt3|fEe!?7+>|A2b
z<!2>J!)v<o6JO6y`(GI?jQbae#_wigB|8*j2%3b}%<TOVE0kZ{n%`me`EfVo`X<eg
zO1k*EfBSBk+4~lnMwLu9gE=|>k?AG)&O<<U0&RCD^{Kh4k7LV|a+l>y9O1z<eWl=~
zdiKSX4K=20J6JIH$C}3#aD}qJxHU`R4=jedS+U0kh-v2Py#<y$a5r~{QFs)kkzHb{
zy-K;xKeqB{tuyI-+9vAyQ#*UXwxM%9ZZ8J9j$i-TR}XU!-G!Y@azN=fhg*Bi@Swdz
z@7h=Mby*_YovGhWE|;(UI?<5pWf5}ssZHFXSFdodd4-bh(SmQ~2*T}S&<B!uK_&L@
z)_8(dlr!zMWc^^yi8L77P~Sjc(_D3zqMugkT>Wo#hW-4KFA;)Nn}y<cC@)r*atU?s
zyoeIKsq<Fonhq(6xB6LJ&f)^yMx*iIi_rDFX(zQ0kj6x8AcTTho-~+1*OuD};3#8+
z%1DJ1nlrNh;Bd20xJqzK%Btr+)-Ha9>BFLx+HvdCA<cRjP61DS+D?j~^7&(BQuL+R
zM5`Ii#jf8Tf^GPsfOP3@gz?(unj!`vaZuQcLu(UG;BNKl$I9{8s^uGxRthzcMp=vb
z5LZ3WNX}a&e%|5S+*6pr4cJIIBTo@i2PrY~Ta9BsX&n*|#f#yuy@+PQRN{UIwXA7c
zF;ZcU4#N|xa9a*O^8<q9Jn=7Wipg?uy)wb79H65Cn`^?<Fs6=QzfNhXRIFN)FA3+t
zmrqH42T}p57yn5$dJxV)#aBt2pn#1$dkhNsdq|&!i>evZ`z&sMKT+mDwq^D6xu{Gq
zf6hQE4aUGj$)U2f*BjfES(^$5wd_r1)K7Mt_vCf|vbU2A^P;<*5<B>mp6h9({C2vn
z8Vx>Zw|sSSg!QF4S6zV{{E9f_*>Sg(zcx9ejNg}NL&H)1WQj2-^L}BO0;KjE{s49+
zyY99BExBXVlZuH1N;qx}f5f%wS{-U(vSHa&oO+A9N_u~pjVxX*-)Ni_!;zq|b!@v9
z81}S24lLQq^p}(k8#TI_FX!J?h3HlLd;rH4w5!oy4z4ASmciu<Z`YkCWJm^j<>Jui
zq1YCqx-96-5p5VM6gTK^G`^tCH<Fvj%uKapQ@IhxZ?+Y=IzBP6KK;||E%#exrgJ8q
zC~u<jm0>&K8vMq`XPc^92|tyWR46A|i#R;C=HGb7&INV6d{WD`we+?QxsMU<t*UQM
zrS+G64E+Kwh(d08#(Kv?PXh3W;5ZR;&@YwBo&CFSu9=w+B9@zscdSK8g1gnFOASf8
zx_)N)gK6&0v_IsTa3tAbz=w>}<ZCxTqn2gpx85EEM~%_xQpP~Jc#sHMSWJsb(Cbuw
z^$%&Gx>0Acpmu5xH&?gy+e{J^qXM(GQj(tJi|`Kb4sq>a?%Z)SdfEJ$#MP@QpBpmP
zJo;hY;KM_?qwWKj-a+%hjWuDBw)>Ew$h%5cNu60uVogy9d*ymQohUI=^M*$wXo*kw
zG4gsQ+-7_aHr71I`-k&0jmpSAr?dEFq>|QFQmEy@6roHYEB}2*fQav6F$W||!7tAO
zm<l$Sq$N1aPR>Ky@H1lqjy(_9(8JApmg{RPxhnGQ*ygDBP=;n?DwJid#@FIy-_nRK
zlj5)@H}Nbz*aW7PpFSR|xTQ~-z|_Ik9J4w>R#BIk{?lMZb~<3!N&V)D5qUE}6UdDa
z!YMqNCz9^y8Gj4mYK0LFK5Y$F%RO%1wp>@EpF6}lqkcW!w_eXx=l7s-6caMh&y+Bn
zAXR(b?OUTg3J$k2$s4if;0mJum#DMFyXD3qf7bpRaP}(!1I_PLUnYqyg+kqbtYe&e
zY{-pab)N2UlAa7iaf^iD^hvh7ukfoZS*H>7$$fr?rUrND;-L^KiD}{T>^!t-x&|bQ
zUXr^)JsDh5+kdz|jfBL$Df4Z1NWI037FGT}OR7ZmD#C?zBw9;!qycI>_iBcQw0^PJ
zr}C8gL~4TDf)iebcW!1coaL&!y{*qB$>8()$lLr^L3@k=z9!}0=DNrG&GjE*AUOxL
z$g?&U+1oemx+D$6xbwxU-0#$$*Sk4`Tl702&v7Sfd86eQWp{vNz9130wQz6rD7T$q
zIDMgd$miN>=NL}*&vHFiF+^_vp{RLNmt5S!w?4T9qYcL-M)_Tg3F}ioQnhM{CZ!I@
zpz?c-V8G16-OBBeBb&bU`8GN7Je?@u{Db)VXuTeNy!5_X?y(GE)$uZ$(ylZ+Neg)M
zvZq;2kZ8I~dl!CL!-u*_yDK~P%?1R_wep%T6GT@&%ubBHGLUMiQY8_5Pp1GuUAG3t
z(d6QgZ}5mR-mic%!Pp;4%OYn2N5|gUuS4SK?jK_?m?q9q=j7M>IqOKNI`^tI+sMx6
zoQ$-Gh42<eaoxwQ;yiNpH4^U(m2x5iz_U^T#5R;<!3HHztCN)ThksT*$bayK#186g
z41kdTL!h8s$l#FQZe_m@fE=JQzrg~qs30^$-!cVXH1OGXpwg~8{e>kwCJ6=KWB#G1
zX44%ZsBB!fVI0kVPU}X}hR?x8p6M`7WZpLdO5EI=67g;F7wHlp@w?6b_r<OX)b7>J
z{OvH+{hfE;aOsl;WnSOjQtTWx`i1MKwz~v=WDG=)%j9LKp!~1YWKU9mHS^zd<XGp)
z%ey%~>@qyxjW9o<(rjz`d_a2)=(~-e!~Ac%<O<eP^dNrLr{{}Q-ARH~enMsYlqhPW
zmUq-<H{V;oAc{oVyDG=<pnwuh;f1K>5&jEHUeLVRo5c1wBKuNc+ce%0JHCYrECoX8
zf4g;wg>8sl0{!0Md@yU+TOXMrbAo*B(2t)^)0=bOx~p6GTdCY^?1yw|Ec^bB0z{th
z!Qtt>pbp^Jn}2*CyCizKx{}21v(-l#h|bwNiEt0izCJmdKWY&O2N!IVEnmHJjiV9x
zzS{t*TWZZ@7J#&~qVIW;=g-Q@!`evD@}E!dr+>n<C_ZYNFL|oemPwz$FHi0Z`#LhX
z@_4A+aC;B6!|?mKZvbCXE(VJ<o{g>;;V^%`!mty>Q&|?cxEK$ZpE*X6t@Dq4lUL!d
z(zg=FSHO87W<b*nGPavwS*$${-IJ*gmGN&wmg<P0M-G*V_wz;Q3pSJoux%D5v#xlK
z!FWXIr$;-eAeFL;rKXI--kX5!D{8(s2p4kt6P1*FE1X^4b@0(5wc3ISDjQ7#UOxFf
zV35ZDXG(gTTfgo4G$bd2$iC)W&t-9!nP=1b$3Dz_Yor+6R?>DJ*n(!X@HYkwFs`>W
zvV+uf>s+7jP+1G=@?ZoY(--xi=X2qFU8)T?wa5jHs}YA;)6bf0B*$oLUw89Dx1(5c
zGL%}X&dhcE5A4H&W*=NvFP^ERgmQAj&?p;*KtJ9|dE)Bb-TZg&3%|-&UDK|TqfN1}
z)zj(aCQH)UxIF!bA-=w3tLKf}(d}G&uvWblp`e4-e^NB)FSEXfzPxQfR>StQ#3Dm1
zq+Ts*VU(@pJmjt;Tt$C#BPt-f!AB(>dObB?vA-9JJ%&5O90Cz~Jsf5jX7YM3&kZbC
z;tFyuRk67#)dh=%%eM9V^pf4*u-wIGR~^uZvVQ6Ico}XdykH{MvQ1s!4ZCAX`5lAH
zWBL^}0=*V5JyWMMdR<C}{t-#knwMr7dX)&R_=n~09?(ql9+AlK|4l(;=dQ(%C-C{H
zUb_T@GN~!I2K>ET(y!3PJrnM5X03FPcGx;y=y<?-A7+^K^34yT0pURNI^8cZM=^H~
zTl*gw8OMxXXRf9^xn|nEesXdiqBWP%1eh+03LD9;TBpx}Nwv;bpDz=<DSM3L=kV~)
zEVf1FUT<tF9q(cw&8VX(WG+ynU5pgo7hBJhn6Hjdg=9qKS;jNU#1lz;0iId7D*Ih*
zRo_1$K*aq4uPLDzLqTc<bz%niq)Glj$k&aYk)ED^$;UWWyVcbu+!wm^CDV-ZzI~#n
zeA(XTPm)d77por(S6?Mt)%IZSxN!-<bVU1jV7ITb2W6z(2=kMVmfl7@Hebwiub2&X
zDgcT>5|6;oI^LwC19C3|GG`A~8f;)Oe8Wnob6cVCy#jt`iS4~okvgT*^X>_}dIc?y
znP4lg#CmZ}-+0w~^T**HjMy<!Q!RzExUIlhTgZxvKn6WZ3<mf{?qN7_nKb15gnv$w
zK)!v2Gs0-<pLv~BFnC{RmtL4jHYS-i+(Vl!Mym{exH<RB_H;ffV30K?aX-uhs6Z~{
zb}Ltjt-V}uaNPPk6Ab6JqT!KjyRQEO<{_WXl_l${)V+5*l_T&o4L6zXzlG?TM5SSO
zzA>mHh%&z4I@vKNhI;%ogd8Try04Iy(x4uxQ0T%?3xqxf?UxT)eLei=-R<&|8y&Mv
zCDPIt+A`Ba4>f(>y&zgc{3+D^LgOr+?pQrn@G2DCdLDWq?kbzC-2fE#w$?_PpuM3y
z%rcSMZQT5NCLCLw%gCr$aEuzUw`JRrudg#+rGi!7Hf6Ryt+Z!H`8`a?%1E)W1#<g<
z6^O)=F@>x-DqSw~als+>$83v3=ma$=m@6rqIYz$PJVp<(#y=;2d@keEpEI~!qrISL
zbx{f7rasas$%^sWYj9jcPBuD<$X7AX*F99R4M~2Yn#?6H3r`L<qrNSS9Hh7omn7e3
z&7@U5NNl<uS82MIU6+LKG`#g>4Ig9^j4E?oD5ksUOO_bE@zZ-zqhxA@CDs4%8J}@P
zua4!?hL7hj{WWU!O(6>U_#~;grA4}hEtr4OQaZcE>pQi_l*{=cw#oFkQaDG`;R_Dw
zBfv=BGiBANxD7$?UMQMV*hE9g?Y+tC*@mBV4^af$B>iElcG&(5Qt0s|m>n#LQP9O#
zZWs?E4z_9E!S5wYmWc%#x1AhLC&KjdU^ES7lJbFWVz(TXjf{auG^^F@7t?3QS6u3Q
zkeM%cI(UcL`^@VOlNd8BysGUHB4Z?CaM=Ex3QmF0{5$AQPeHT!vJTI>z$r}In=-Fc
zq!@0NXS?+EzL2Q7iQd}*ndGr8g|?T4g@qHALQNT>cYhb}t5+ZK?Yu5%WDI8WO9;5`
zjGOePC*|eO5f9p1{VOoinF05>GNyYn*P74Vu`>yM!M6FVKA_3!Q4h>!dT@+J-CZBZ
z9YJ%f!Jfw7ubF-qyssyQ1tx7?KFn31*@Kwq!C<AA&W<Xu2&N%eP_1BlEDulgh&^*h
zw1Ae?v*O3|wHs@!`eb27a*l0fe?G{ho70&1UAA2z>oNLf+FvJA1ZsIWRM<p~$eER5
z&i3|jbI;J%7J)(CjpE}!r-~hsoCn{Bk1uJ|(0)wC`K?QZ+yH81`ZQFf7b!7=8=4*e
zB;%D?s_mn*Sf)J^cT!A<9ZFfmDSczU!eeY&m6jIWSrZMsbn#iruF~O2E6An%_G3-N
zstAB;WHBw@lrB>ii@a%>fz!DKzg!m^`=i9b?t#j{kAJ!`{Z)&os=vw6=`K36q}-xn
zVug<ttlUjfjU0~dEZ9iKq?Zi66De;P>bO?FRoN&R5-CT153Omrq;P+_sr%<ZqtHM%
z5@@zi&9h$l+sbB$zjT-6B;JD<NbMcYr&%>b`TxVL<t-PD){C9EyM}(Z#-Vk4yXzLd
z8KWx*>(uT8y{?C%$Ry}KhWQ}Hy0K<z`?!=~U~e8=T+F=mR+>EJUjE?<b4aKnD&cb}
ztkrQsrb>4^Yy4ALdBN~SRD^ONCE=g3Z!v68c_j)Mo%LVZyZ;yr&YTk&y4#DYFYFk7
zdjdN$;|ArZV*I#>Js2ybNJAC|Yq@a=i*j;x2d}N3d&s=hw7F)+)&8?wg9KuIi=#d#
z9uqgydN>-26}p3Mpl_8<m1#6i+b!pK{il{yIX5MAhHYXqx|d=zm<k6Ni_C=psE{J1
zHx<?_n_i-rzRrniXO9Mw!d3i>_f0bcF`*bI9(Szr-wSL<_T%KWDEc?YWWH;h+Jzkc
z0=%CsWdhYYcRmZnBrOKWoW5spy=eL{&iNzIJVE^ZJpfU3xZV_2OBAXdztmCH&jiPF
zhR*Md;rE@NDE~DB1qFO`&EK3i3hD8NXSch=EXv9Y5V?v)x}J&Xb{?bcj!Dbr&FY#X
zevB6zBxCxY=kft7&Un>(KLZeDl$6)kB$SqH&^EAEluDXqfN-~ryGQ;TroauGp>yv&
zNs7u=q^22smET`LpDbP7$Q$&+dYTMYH~6g8Pddc1<5Qlj`nM&+**n4q3rm;mi2*<#
zU2fA+V3`+yebEsDcqlIABmjw6F?Zw%T0ak6sNM8wG7y{?TB)w0JMLr>w}rEjZ<ivT
zo(~C1j6Vw%B6s!co>)-nvmPyFdQGPR_ZclwxJq)K0~Z{zQcviML~DV?tu6-IJR+bN
zKBL{a^Hj{@f3nvj3(>-7&Irg7hulw;3YERGhcnHcUtiv8hbtw-I4$y}jF5<BM+w;G
zziDL~TF`VbLTdMR_xh3Om;Z9ebO!Kh-Tob#g~hF05?-Ht(gfn7=)29cowoAKbC|Yy
zRqM*@o2xw*KLf%;Wa*(aCG4ilhLGd_`%OW^X=bcQA=;NkAEgQu+O5I&)da^2^q#qQ
z?id)lsQfvmUA8eTIZq7*OK^4e2W|&UleOxJ){F^QmqKv-dy~>g{yNJ-%_SN)RKmje
z+=9shHGp9ODYBD>6coe7Pd3~q#a*Y~@}qoDPJ;8GOPD;vEE+N!S@^J17R^347ON1l
z=+!sXR1<)m_>m6txsa7FW3|ccaA@dMmALv~`bh?wE<baadsN*zDR(5h$7x^Y<Gau*
zaa8y$hi`#Jx5`sYaQ!a!KS-=7k6Z}aB)HqzeTiLeQ^vm}-6?f1Ejt-{(tZK+H49h|
zdn1lZ4sp4z^-EB;E3|Bi(Glc6K0a8e3Tgv?Y2mB5`nUoK5`(*WwRo(Ra81_c(xM{0
zlmVepJW4|t+n%ZAc1s)rdCGqHi@GiEP?uJTs#I`MlnP5#v>5Mr0r~imhd|XoLwml7
zw}$D3IE?E+X8`}6-g5vj>2f=BQD8w40cbl`Fb!xGyjALbc6p|6YRY}J(Jgl}Ftt2h
z;UC&H%411pQ6tPx9&!xswKoHt<i9pu<M528!=K7J67LpQ3lmws1xFxt{OJL##<FP;
z&P;x_n1)kZ`i6#`d7E~*3faS6CM-U!$i^QDy2pUp1b2kV&s;ZP=1c~`(z7(KZhkDD
z-<)x7k8qprC3P=dyXxCLA`+g;eCb8UZ>@CyA_b6xktsza0#n&Q&&_zT=r6G3+Ee}v
zJ0an8r)qOwm*|K>OYQH|V*)Mggl!ck6|!v^!=YExSI~ccf7|rTt6d05BmlW}#u>O*
zy)^>o`KUDfDMiEIzb!0h?D&<*7|di9(l^ns(YjTx(bm`S!q!4HOS9Z3DH~`E4JS2+
zB`x~M<Yf7zZom(L)YCHpc`W5&z&EFew@EZ;CoD*jYQO64?5x3Y^#~6X1|8_q2AYGz
zlz2K$NU}+g{gaXv<1%Y|y_tenoHF8^UCF2K>C}3W4sVTjk7V0FBSYRr(F;W*2tgnv
zF9xhnK|3=!t(GpNEdwmwL1SUU|9JGrJ>5Z#wk<%k2Wf-e$4&mpF}@Y?Pmg8g_gB2D
zJ=Rz$0qK8xeuH3FOtBzT0C3#U<e7oLe%E=!u7Wuk_jwtnhBSJ&3^aQCz#TVzRRDJq
zT1KGokZ%Ey3rGP%7UJV}z3iOky4cs{QTos{c^=cRe{<HV%T-I`pEHP8n<phje=;7)
zCqa(=3~nv?hseFIf&#(6wO6H!jO6LT{X)~+latjO^VDo7xFJEta0oY8BD<u?YBwwH
z%m9)h+i%=uG?--?cIK5_O#M;oh%0oG)|U$}x_U!m$c))(Uh{s41*{3d)P7nCrUI6_
z-!+XWesGMFjI_u<3a}N-(Kjk{=1+D#EUxQ$QUeL{D~p%uwNShighfmDYW>4~o<{VN
zNCfmI4lue)Uq}JaUGs9l|HI-H!}A0dQ!I=0aM}`O*F0uky<WyZsd}H09M9Z!yy$45
zCVvIMcWr&+r5&k`6S)%%cSWs1g1Q^T^?m0PG?FDcZ_E(n@puIB3<*@!*{`{8E2e>^
zMBa40s+SlQklY-I8R;U~sRzsRx`i)$@T06(ZUC&2?5O`3Fp}X0RS1*A?~zX)Vdd}3
z_|K%K1z0=8kQHCmj!y_pUNnCpP#`CfNCzN>0KMk<w-s_SagB2?@Ep_98nyaqVlsuY
z=Zp34h5*s}R$e#$(6b&5%eU1x&&Z8r!ukMx_zIirJTE*)(+W9iSqAKhpoAvL(|IXz
zPwBlJ?}&!ajX2EPaAv^;x}~|@I?%DMXYhX>3kuTxi6{nQu(3=QuDGT(nmV`J!7yw#
zQAGqfc0E`*>U^GcTLA{DZRgLvWzqyt2WsaHKz;KjQJey1Aism^-VRDUSX4DAI#MJH
zmc`1fb~D}zU#_NCC??%$F=^`RZb@=!0j7caRM{}wzwuN4YHi{U|5=sckKAlM=L|z@
z<1{)HqgtFKx+d-~xC_1HO35XHE&sF4FcvkQ|7Q~M>)_i}Z_Onh6v<e9r?2r=)&8zW
z;cJ}{@V|pQ)r2wIW2CcCRe1IhRzY9{yIS=qr|rEDlB8HBmFs_$NM!jvf|-;L6x;#V
zUVOYc&Mo+rLMFA`XfLh~l@ee{AP<mAWVjxYr!|CI1J}IoEe_Nq5HvpCUf5M-Yh&9y
zv@R3?hES=F5-8-1<B!~FA1?O(d4E=a<OZFO(i{bJ7hyfEh#a3SSN-#!-Nb$>APxC0
zzWd0G)o%2`kLk3PX($jff#EC~@zR)W)v9@C$~MV+?R<flr)@W{*s%O&`|tIXFpImD
ol)(M}|GLWm+uJ(#DMoRGij0%troC+pfV4m_)U;G9m0ySdAEI_N00000

literal 0
HcmV?d00001

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 2c2ea871..ee8aff28 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -109,7 +109,7 @@ pygments_style = "sphinx"
 todo_include_todos = False
 
 # repo2docker Logo
-html_logo = "_static/images/repo2docker.svg"
+html_logo = "_static/images/logo.png"
 html_favicon = "_static/images/favicon.ico"
 
 # -- Options for HTML output ----------------------------------------------
@@ -117,10 +117,7 @@ html_favicon = "_static/images/favicon.ico"
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-import alabaster_jupyterhub
-
-html_theme = "alabaster_jupyterhub"
-html_theme_path = [alabaster_jupyterhub.get_html_theme_path()]
+html_theme = "pandas_sphinx_theme"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -132,9 +129,7 @@ html_theme_path = [alabaster_jupyterhub.get_html_theme_path()]
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
-html_sidebars = {
-    "**": ["globaltoc.html", "relations.html", "sourcelink.html", "searchbox.html"]
-}
+html_sidebars = {}
 
 # -- Options for HTMLHelp output ------------------------------------------
 
diff --git a/docs/source/configuration/index.rst b/docs/source/configuration/index.rst
new file mode 100644
index 00000000..e68f1409
--- /dev/null
+++ b/docs/source/configuration/index.rst
@@ -0,0 +1,10 @@
+===========================
+Configuring your repository
+===========================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Complete list of configuration files
+
+   ../config_files
+   ../specification
diff --git a/docs/source/contributing/index.rst b/docs/source/contributing/index.rst
new file mode 100644
index 00000000..ee8ffe00
--- /dev/null
+++ b/docs/source/contributing/index.rst
@@ -0,0 +1,12 @@
+============
+Contributing
+============
+
+.. toctree::
+
+   contributing
+   roadmap
+   ../architecture
+   ../design
+   tasks
+   buildpack
\ No newline at end of file
diff --git a/docs/source/getting-started/index.rst b/docs/source/getting-started/index.rst
new file mode 100644
index 00000000..5b46ce0a
--- /dev/null
+++ b/docs/source/getting-started/index.rst
@@ -0,0 +1,11 @@
+===============
+Getting Started
+===============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Getting started with repo2docker
+
+   ../install
+   ../usage
+   ../faq
\ No newline at end of file
diff --git a/docs/source/howto/index.rst b/docs/source/howto/index.rst
new file mode 100644
index 00000000..fc660d0f
--- /dev/null
+++ b/docs/source/howto/index.rst
@@ -0,0 +1,14 @@
+=============
+How-to Guides
+=============
+
+.. toctree::
+   :maxdepth: 2
+   :caption: How-To guides
+
+   user_interface
+   languages
+   export_environment
+   lab_workspaces
+   jupyterhub_images
+   deploy
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 17b11672..6a58c72e 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -25,38 +25,15 @@ Please report `Bugs <https://github.com/jupyter/repo2docker/issues>`_,
    :maxdepth: 2
    :caption: Getting started with repo2docker
 
-   install
-   usage
-   faq
-
-.. toctree::
-   :maxdepth: 2
-   :caption: How-To guides
-
-   howto/user_interface
-   howto/languages
-   howto/export_environment
-   howto/lab_workspaces
-   howto/jupyterhub_images
-   howto/deploy
-
-.. toctree::
-   :maxdepth: 2
-   :caption: Complete list of configuration files
-
-   config_files
-   specification
+   getting-started/index
+   howto/index
+   configuration/index
 
 .. toctree::
    :maxdepth: 2
    :caption: Contribute to repo2docker
 
-   contributing/contributing
-   contributing/roadmap
-   architecture
-   design
-   contributing/tasks
-   contributing/buildpack
+   contributing/index
 
 .. toctree::
    :maxdepth: 2

From 4045cabb730b39ef004e450835e012f41acf2f3a Mon Sep 17 00:00:00 2001
From: Chris Holdgraf <choldgraf@berkeley.edu>
Date: Wed, 27 Nov 2019 09:49:46 -0800
Subject: [PATCH 2/4] howto index explanation

---
 docs/source/howto/index.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/source/howto/index.rst b/docs/source/howto/index.rst
index fc660d0f..2b4856ec 100644
--- a/docs/source/howto/index.rst
+++ b/docs/source/howto/index.rst
@@ -2,6 +2,8 @@
 How-to Guides
 =============
 
+Short, actionable guides that cover specific topics with repo2docker.
+
 .. toctree::
    :maxdepth: 2
    :caption: How-To guides

From af42cd0dead031d20f746fd01c2c00f3f51593b1 Mon Sep 17 00:00:00 2001
From: Chris Holdgraf <choldgraf@berkeley.edu>
Date: Wed, 27 Nov 2019 10:56:27 -0800
Subject: [PATCH 3/4] updating config files to avoid links

---
 docs/source/config_files.rst | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/docs/source/config_files.rst b/docs/source/config_files.rst
index ad2a0985..26f269cb 100644
--- a/docs/source/config_files.rst
+++ b/docs/source/config_files.rst
@@ -17,12 +17,8 @@ GitHub contains a list of sample repositories for common configurations
 that ``repo2docker`` can build with various configuration files such as
 Python and R installation in a repository.
 
-Below is a list of supported configuration files (roughly in the order of build priority):
-
-.. contents::
-   :local:
-   :depth: 1
-
+A list of supported configuration files (roughly in the order of build priority)
+can be found on this page (and to the right).
 
 .. _environment.yml:
 

From 51e26fb8a41d49364d5c0a74fd9b55e98f53b45d Mon Sep 17 00:00:00 2001
From: Chris Holdgraf <choldgraf@berkeley.edu>
Date: Wed, 27 Nov 2019 11:30:37 -0800
Subject: [PATCH 4/4] adding short explainers for index pages

---
 docs/source/configuration/index.rst   | 3 +++
 docs/source/contributing/index.rst    | 5 +++++
 docs/source/getting-started/index.rst | 4 +++-
 docs/source/howto/index.rst           | 1 +
 4 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/source/configuration/index.rst b/docs/source/configuration/index.rst
index e68f1409..fbd26c20 100644
--- a/docs/source/configuration/index.rst
+++ b/docs/source/configuration/index.rst
@@ -2,6 +2,9 @@
 Configuring your repository
 ===========================
 
+Information about configuring your repository to work with repo2docker,
+and controlling elements of the built environment using configuration files.
+
 .. toctree::
    :maxdepth: 2
    :caption: Complete list of configuration files
diff --git a/docs/source/contributing/index.rst b/docs/source/contributing/index.rst
index ee8ffe00..2973791b 100644
--- a/docs/source/contributing/index.rst
+++ b/docs/source/contributing/index.rst
@@ -2,6 +2,11 @@
 Contributing
 ============
 
+The repo2docker community is welcoming of all kinds of help and
+participation from others. Below are a few ways that you can get involved,
+as well as resources for understanding the structure and design of the
+repo2docker package.
+
 .. toctree::
 
    contributing
diff --git a/docs/source/getting-started/index.rst b/docs/source/getting-started/index.rst
index 5b46ce0a..96e5f295 100644
--- a/docs/source/getting-started/index.rst
+++ b/docs/source/getting-started/index.rst
@@ -2,9 +2,11 @@
 Getting Started
 ===============
 
+Instructions and information on how to get started with repo2docker
+on your own machine. Select from the pages listed below to begin.
+
 .. toctree::
    :maxdepth: 2
-   :caption: Getting started with repo2docker
 
    ../install
    ../usage
diff --git a/docs/source/howto/index.rst b/docs/source/howto/index.rst
index 2b4856ec..c7ee34a3 100644
--- a/docs/source/howto/index.rst
+++ b/docs/source/howto/index.rst
@@ -3,6 +3,7 @@ How-to Guides
 =============
 
 Short, actionable guides that cover specific topics with repo2docker.
+Select from the pages listed below to get started.
 
 .. toctree::
    :maxdepth: 2