From d2a59a4e9b046619a9eeb42df5423e396f89f593 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Thu, 26 May 2022 09:36:44 -0400
Subject: [PATCH 01/18] Change to RTD theme

---
 docs/conf.py | 10 ++--------
 setup.cfg    |  1 +
 2 files changed, 3 insertions(+), 8 deletions(-)

diff --git a/docs/conf.py b/docs/conf.py
index 3b2d99a61..54b188ad6 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -99,14 +99,8 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes. To override the custom theme, set this to the
 # name of a builtin theme or the name of a custom theme in html_theme_path.
-html_theme = "alabaster"
-html_theme_options = {
-    "github_user": "asdf-format",
-    "github_repo": "asdf",
-    "github_button": "true",
-    "fixed_sidebar": "true",
-    "page_width": "90%",
-}
+html_theme = "sphinx_rtd_theme"
+html_theme_options = {}
 
 html_static_path = ["_static"]
 
diff --git a/setup.cfg b/setup.cfg
index b88a0aa40..d14a6c573 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -50,6 +50,7 @@ docs =
     graphviz
     matplotlib
     docutils
+    sphinx-rtd-theme
 tests =
     # Necessary for Windows until https://github.com/pytest-dev/pytest/issues/9765
     # is resolved:

From b8089e784a886aab2cbf964f0f5b40a077af9a9b Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Wed, 1 Jun 2022 15:04:02 -0400
Subject: [PATCH 02/18] Update CI for standalone doc build

---
 .github/workflows/ci.yml | 7 +++++--
 tox.ini                  | 1 +
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 70387ca38..d82746b2d 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -57,6 +57,11 @@ jobs:
             python-version: "3.9"
             toxenv: codestyle
 
+          - name: Build Documents
+            python-version: "3.9"
+            os: ubuntu-latest
+            toxenv: docbuild
+
           - name: Twine
             os: ubuntu-latest
             python-version: "3.9"
@@ -77,7 +82,6 @@ jobs:
             python-version: "3.9"
             toxenv: py39-gwcsdev
 
-          # Fail
           - name: Numpy Dev
             os: ubuntu-latest
             python-version: "3.9"
@@ -103,7 +107,6 @@ jobs:
             python-version: "3.9"
             toxenv: py39-asdfcoordinatesschemasdev
 
-          # Fail
           - name: Pre-Release Dependencies
             os: ubuntu-latest
             python-version: "3.9"
diff --git a/tox.ini b/tox.ini
index 46bc524ef..caa4864e6 100644
--- a/tox.ini
+++ b/tox.ini
@@ -76,6 +76,7 @@ commands=
 [testenv:docbuild]
 extras= docs
 commands=
+    pip freeze
     sphinx-build -W docs build/docs
 
 [testenv:checkdocs]

From 1779b3f8751b9885efa3209e59acc091b5a5b5e5 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Wed, 1 Jun 2022 15:28:07 -0400
Subject: [PATCH 03/18] Add graphviz to docs config

---
 .readthedocs.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.readthedocs.yml b/.readthedocs.yml
index 6a55db525..bae83524e 100644
--- a/.readthedocs.yml
+++ b/.readthedocs.yml
@@ -2,6 +2,8 @@ version: 2
 
 build:
   os: ubuntu-20.04
+  apt_packages:
+    - graphviz
   tools:
     python: "3.9"
 

From 99223660d21899aaba85a5312044d76be993eac7 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Wed, 1 Jun 2022 15:42:33 -0400
Subject: [PATCH 04/18] Fix warning

---
 docs/asdf/developer_api.rst | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/asdf/developer_api.rst b/docs/asdf/developer_api.rst
index 30cbdbc29..09339557a 100644
--- a/docs/asdf/developer_api.rst
+++ b/docs/asdf/developer_api.rst
@@ -10,6 +10,7 @@ to create their own custom ASDF types and extensions.
 .. automodapi:: asdf.extension
 
 .. automodapi:: asdf.resource
+    :skip: DirectoryResourceMapping
 
 .. automodapi:: asdf.yamlutil
 

From 621dd28cc6f1421de5955122295ca3eb0453a1ff Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Wed, 1 Jun 2022 20:54:29 -0400
Subject: [PATCH 05/18] Update resource so description appears in API

---
 asdf/resource.py            | 12 +++++++++++-
 docs/asdf/developer_api.rst |  1 -
 2 files changed, 11 insertions(+), 2 deletions(-)

diff --git a/asdf/resource.py b/asdf/resource.py
index 08b8a4f7b..0dc4dfbd5 100644
--- a/asdf/resource.py
+++ b/asdf/resource.py
@@ -5,7 +5,7 @@
 import pkgutil
 from collections.abc import Mapping
 
-from asdf_standard import DirectoryResourceMapping
+from asdf_standard import DirectoryResourceMapping as _DirectoryResourceMapping
 
 from .util import get_class_name
 
@@ -18,6 +18,16 @@
 ]
 
 
+class DirectoryResourceMapping(_DirectoryResourceMapping):
+    """
+    A resource mapping that reads resource content from a directory or directory tree.
+
+    See :class:`~asdf_standard.resource.DirectoryResourceMapping` for details.
+    """
+
+    pass
+
+
 class ResourceMappingProxy(Mapping):
     """
     Wrapper around a resource mapping that carries
diff --git a/docs/asdf/developer_api.rst b/docs/asdf/developer_api.rst
index 09339557a..30cbdbc29 100644
--- a/docs/asdf/developer_api.rst
+++ b/docs/asdf/developer_api.rst
@@ -10,7 +10,6 @@ to create their own custom ASDF types and extensions.
 .. automodapi:: asdf.extension
 
 .. automodapi:: asdf.resource
-    :skip: DirectoryResourceMapping
 
 .. automodapi:: asdf.yamlutil
 

From eef74f64f93cd342fe6bcb9cc1b314f985ae0fb7 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Thu, 2 Jun 2022 09:05:41 -0400
Subject: [PATCH 06/18] Change docs logo

---
 docs/_static/logo.ico | Bin 0 -> 5694 bytes
 docs/_static/logo.pdf | Bin 0 -> 10668 bytes
 docs/_static/logo.png | Bin 0 -> 16762 bytes
 docs/conf.py          |   4 +++-
 4 files changed, 3 insertions(+), 1 deletion(-)
 create mode 100644 docs/_static/logo.ico
 create mode 100644 docs/_static/logo.pdf
 create mode 100644 docs/_static/logo.png

diff --git a/docs/_static/logo.ico b/docs/_static/logo.ico
new file mode 100644
index 0000000000000000000000000000000000000000..b31899f2c89a14b6bf00b23bcbb4e397bf9f891c
GIT binary patch
literal 5694
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

literal 0
HcmV?d00001

diff --git a/docs/_static/logo.pdf b/docs/_static/logo.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..4aedaf22c22b7daff23acba0189cb63fcecbac9d
GIT binary patch
literal 10668
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
Ue<EaJWMyW9qo5F#`wsX20J~xtWdHyG

literal 0
HcmV?d00001

diff --git a/docs/_static/logo.png b/docs/_static/logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..63261feda28a6e5655ce67c4d8b0a844e714f3aa
GIT binary patch
literal 16762
zcmXY3bwJbK*CqrM1f)9@5fBiNjsc1^lF~3rx*JA`bPNP3>8>$)^av@XyBkI~jE;By
zzV9FVgZtUedCs}dxx4r5K18T0%i`lw<D#LV;mgZ?Qb$8WhofHlPq9%WA9z*gQGak*
zOG&B9OGz=Rx;R=`+nJ-Gv67h?8^3pQb9ON&Ha7k<$j*lA;;9}U9<6TN*52OHKFBy=
zJYbxWVqmaB`C_FL?TPobcL^gknQwDX`%~h^GQ9VAnlX&A?2XyQPl|U5U(gifle6%0
zb5o<u&LWtxB%OPNCF|tW1ybPXUGH$8xnM^!pjTgyz1(MK^dJttf71011B6k$i6`eL
zk}}wZZp!ju<~^f_ybabLAokYX_rBbL^Jro$CQM9BtlosX{4XIZeQWU(3#M4ZEgN^a
z-|up};wMP6^}=r@n<$^W#QpHH(8S8xI_DXA!7KDgoN(tX%#PK5RuAl#p_QzSwZ+f-
z%)Y+2FlOwMP2rLK9@r7UhKbqF5S${<h1rQghmHME@|1^P3L6{U4?EP)6|J*E)p4J>
ztQM8QXHIguu4rf!#Q$FCmRVz{1WTOAfBNvn3;n<_s+w6alGbtH@$s~*3Y-SPenK4o
zBa+6suJkqiuV>5`3y0Q^Cv6e|4;m5$l5CZq0wo@<)+-v2shn~3-;*#LupWjF)Cf?I
zRB;n93fc>BCq|lUov?1-VI9*f8y4f)vmIw*@SiV1ta;vIDFmu#lfED=&S80~(SO8>
zwp{ISQ;6sW(X@GrKvEWpCGp`j5UrF!TrZq(;mXk;4_M@Q<WXQA_g{$^1!#Ga_yCy%
zJ&;u3JocZbOGH_MrTQESfjn3?+u$87V1Z;Y27k*(M455HH<TrSTIyVbZeW>IaOY(C
zs8NIsztuh8{2V(9L>pOgj&_FAm%s{!1*5Hi+UvL1EU2N&ztvl>?k9sDAuX=%Mmg81
z7?1bVt84nW=~|LB9#cm4AfXXo_BEf%1ba3oy}+A7&nAq-M=q@G4ukk}vdV2N0rF=5
zx@uOeCAI9(B~cj1n@9|nwpATh{R5#?D3{>A9?d&tXd*@hyQ<U?64$6JR<u}lMYfyj
zZ$?Mhx)COqlsT>xHYytP;*Ta*Ef|?OUHJT@KjzQ6dW76Lv4EP{53l+miJZX4x5pt;
zSu`Gu?Gz1<`rA!xSkG}M1OY*E=GDr97ph4Fj_luw9*G#(>7xuGftzOCxI6%7SUOA_
zw<RBy;^b0Y1AmQn(6N5lU&m*}?{tJ&f`LC20uiXW(|_m8eEgPM<eSWW%hjs`0A}Cs
zVG^!*+3vSk4*#O!OnjT(PgeOn5y2Sz1YpO#Z?p1jZPJBJ5;du^UB&afxK3g2M?W0n
zTrLb2rj9mh$QXLTYjr(2;_gPczM6qI^Jzv<-;<?6Nk=PdNxo%jk5m^FuH%3BfysKG
zv%h()Xn3VBZcDD1jv6!{qKAc=CoI3aODrP&Q;Nb~mPpk#DawJ<`Ofop?q&JOWGEf!
z$1_7<v4SeDLAm5T=<F1um4E^Jo5vql%#Sto+mrp)5j>`y&N<E&-lIB#i}g*unqg@+
zNmRD@@PSDl<4(*R0*oLX9HmNeJ)5XO?LFI3nen;{g+Q%9Y7q2QvUr=5P<zMF$v6JP
zku5vnW;<r-XxayI_PM$}E<hfE(aMebq60!bpwQD6A<}TdxRYX71CJ;4oGBl`sp32l
zHkc+Ic$%;)dDH>-3x#o6VTkQnW?&#cJ7(0Ge)ambhd?0E4I4VkVVic<)_o>+-cG}_
zUQU$SP_RuMu1dF`%0HeJ7b0Eye=CNG+k|Qhe;iOw!^xb7r6{%K$}I%wP8gzUZ-7-*
z%25U`zdVVv{kkRLFy5l3^W$mqDYEP2=7aw;DXwI5hU1l9)3*Me&RMf&yZ}U_3MxPx
z8yO?u(W)2P;g&{uInhCwRTVEmlT{2^1?e%$;&9&7tNF>W-B&Y;o#nJoh@CiDphWO3
zQ{+WSY|_s;@Pdz1bQf2a`icySwTn8i-*-}he>#Y$_Hg7jP0Zg}uRsU>s`7D~cYVbG
z%4oku(Oz|Sj>1qRpP&O$8-%N~H!~H$O}A&!-7dnQXHe4nQXx^G1hrbklfS{30*5gm
z?1i6l3h)&o{H2u!@T#<Xdc_uyUw{Nro(H5JUSSRau`POS4n|U3Y9V`wK8<LNu>CR&
zb;8AV78)7({#ok8M_m*!x``~GzkAZ6Ixl2*<3ya19{KyJ3MpD!2N=yGl4GYI-(oeQ
zs10QLV;^fIK2q&GP0**Iqk@1R0N%DN|0DgXo@-dVhZlXQ{!RqOl!!C`8<UR?!W>NA
zF9|5vpM1q)!y-l{i|Yds?nh-T4k@O+Z<WTflg=aNi0?vsdbpqdJ^a}HmvRAJ6K5p9
zSbm{#PDYC6fQ;5-)GK%WV1%36wYwi8d9O`=I#u|C4fm_aQ`xYXkB&C|x!};*H3_WB
zbj83RREfZY*2X6mKIG9UP1GN@K_usy3>ehh+gp)2w}1ef=Cud62eS0H7Vl6&BT9Q;
zP#<KE5H#d`MI^|etJrgPD(~g-<rAW@84`rIa+}|STyq-iw=aI!7`^dwuwQ9}*{=H^
zG@h?KLe>lzYVRlJ5|W^=JnRE5%Mxi&<?UIi;KexE;ad3=vm^(o(~N#;O~F}TCre^^
zAk6OHS8%9^9*cq8`y8wHvu^AICYMO-emef)=R&SaG^~c3C&Bz7*?y)j#?fex@&wQG
z3lxiW;Zlm`t#7^X;hzv=KqY%FqL89&tJEWUTI!_CZJ})sv%}RnxJ2HnLs_C@28tHg
zwHe;tAe>>Vec%FmYOkRTOo%}2DcW)Gu$&yN2U9EJtR91_Roke-9v|L8kRtp;)+qm1
zdJx}uBiP0>@{io$E9^ykk&IH6G|zmXeKcqYDtRxR6mipz_a4;n%?NHxvc}>BE?u=_
zh`un!c!u|pt<n%xBtPSi=zV#w-;^ZXW@FSyffa8PKU|V!8h~x>!5CQ#pmRx)lkXpt
zBTWhi)XS(7cuO~r0i$WcDHM_Fj9P)ikH6>vO2$Ib&$Edb^kgCf%ct+_$-cF=57#Ho
zbhi4%?!g!GZVx$7hSFE;&s+sYZ8ItMpR`)FGM$J~gS&=Tf}{@d40yK<DO-zBE1-n!
z5FIxQHXgkful*nAUlH1^dt~iR+6Pm%hExhDv<ie?*jc?=^4HTzh~ub%>CT_d3|HeS
zd@{;L<?j|!$?&d*uJq3m42{ssm;5TK8`MyrdHnKO#J3^&Lp9j$o5%}48yENAPb<S1
z3`G4FN2Qo()mT0c$2HVne}xX)i&%8&OT~VXwmJWa^DX$9v0?)s!$<9w?jRLDV}TLb
z-(3yCTp0rgFM0JDRLaxr97~ozr;<-CqrP6JtzOZ|c@+z8>eDkTL4N8BTZ)(I*&UqO
z;Ll$b+03q0inSG!^+xE|Y-<R3qSlJok~9x)bDs}oUS%H9v}=M2L*!EyE+zxO=Or=#
ziD;u~M^;AUU%?p)MP*b7>2Cwdt-1Omf;2lj)sE*}dA6yYE{-o|#>A)&h4+a-GF^YN
zRZLj19JI1SGu7dCVF|%uqWNTci=1qPLN1N3eTM4N47gWZoNS3@s0D~Ax)Pm6(%rK(
z(90=GGlgx*LP|q{vVSXD(Wo5{v$y}~%>Qr8ldp=hmh*fLE&EV3G%(m)+JTM2$>B`C
z4oWx4z6R`X7V&)YP)ym5v}hGHi!C+jp8dCp$r~D5wQ(clpO294pQNviKiI|m+$Z`<
zB#i(4!_&e{!fvG_AOC}gXh#~`3-7SaUsprBnhzeRqMn5*JX#7KDAKw+Nz!tX53<jy
z(S&XEE7h!0G2h_Esy&SQt3S$Ym3VET>UC?PRS+$GHFU5b*%k4U74d}lho|{rrYdz^
zreoK`&fTAvcm!QPPe4uDyf&xIN~rRJaMHbFA$*`ud}>GRH~>YAT#PW3Yl-e+UIOf(
zezyaN4Djq`xbNn%OizVQL3`A{y<S7<SYXQycW{gPVP-m{3VGUAJ-j2N_j5ee$w1kx
z^zH~Xla9G{zX+*><g^&x<lSknof_u~Z3F6pS;%j!wBLnUa2+^1=T<2+8UeZRjmi(X
z9Qe=ut(_5zI}~K6vBoO|hs7AtD-nHgks*aeEwlQb*m5H`F?Pbg1U7OK@rKX}wUyGG
zFmSa@WL5D39x^1TL^EnU2WFk6z5BKMXH}72#<A{Le;?WU1dQ~m8bcc&z>#o%y8bX-
zu1f%DU+u20P6Be&I?DLU`dTR;0LQG&mGM<3GP~H{`ggNo>0y=Af;c0_hwB-{MsK{4
z**FaF*mguWaU8FROzoS|D`2>%MwX<+$S~f`(T3B(NWcG!{hs850xU6lrDo*Zb^PGQ
znA^#=Xpl+KQB-=dzaF3@!)^JdtvorubKnLh<rwOAeW=lXre4S8Myfy<TAU79Z~0>l
zv#9SiLi#V1M^QX#N>%uc=B1&njmF9jkf-$u_6cBO$0%YO&_Acwk8zwxomkdA9z0FB
z8tm~K%^KfL6rVAyfP^kNI5)_g8K)pGH~Jj#xVCqa-DDq%Y1NNDbq_CbiJq8GC+vmn
zr+7{cr?GdB1m&*vDt@zl>iE2Ni~4U+)LHM0Zh0IC>?8t>V}4Wsb5wB(FwI^1a?G8Z
z4(w+QNd);Na!unEjHl1Bh0+(all?lZXicWJA)PK>W>tCiXw^dIU&NC+RAF6;RJ2&2
zW^qti|2rGt4CT|)K)Oj0T79f4`0mQp`c?ETRWhbCxQC-H3s;W%u~zTWO+=zsX>UE+
zOPBz*sqqa0xx70w=h!2aie(o|kYRt=9kWiUU5L-xJe!0M=viZ0NyBS>f4S@BbPuJ>
z)<VT~jP6PQIXIKYFXqQk_*(Trf6pD8aIgx41{`n(&p#PVZ<&ETTt$i-t(G8Vkb#BD
z3&7Nzu!Q{0u+a9xA9ma_8=8F~I<H*)_>=Na6aXB^ni(fbfNw2rrVwpRnJx8JS&H^5
z2Inyo!V5<Dx)m}#jt^igBh&RUsfAO$WERWxrJtuNL(o9l`<kH9bdcYkxgS2ipOhBy
zY1N4HDr5_zADM{s%VlF0TTpy8+ml@JYN;4)nwK+nH%BWDHk_1NCVlL4z8kpAAE6^J
zdj4%eZd9A#6aH{t3sJ}rz0|k>b#uKI@K(1)6qeFWy&4e7wYg|$6lD=UXsRzDj-^fr
z$j0ct6lm{zGgWzhdU4@bz`iGk1@fzdc<2R4pCU{T*8U*MVMe&=`+-KROK?SrbJZIq
zaJETcP#ytc*__`r&|drfm`lY#Gw(%&r&RyngN(AyzYC(bD__fPL+Qhx;G5Xvmj7Z3
zsap#l(5>1eOF4+r4T$)F{Fy({gw%x5N*e&UOVfvsP^CFhHdxhE0u_28XrOJD+qjF`
z{Ok8#G=fb_Ot`SYJ5>e#Tnhma%~OI#W2<h<K;d&qJ}Y9yJS#By%T_F@Pnld@fAY=W
za2OT)k;iCWawO`6t<U9z#p|TjVl$MwAMxjgE>Y?^dYj4j*$ThT(x1-b)9-%#!l{ff
zEHJxhm?i|gpiC{C7J?Wx03X6-&<KdcUYUM6{`<nL(4j_TXk#eb&?H4W8)OWWatvk(
zrH^kd2(%#V*A19}l>1?U0Q`DUzy<N@>hLewyF?`xhdL_wfFIPU+BPern0<O5*(xU6
zEM?a#Hpe<$<{zSgUp!+3Dbn=UeQghDaKA`wl$^Or5f&s8luiz^AfyfArY8+vRarzM
zN;HSbZJb>J%Em|5O%O}vRiQ-B<Z|6JG0}5Lr;-w_wiWdyvd@*N{kQ{My}_U_pZzPG
ztWTTYz+7Yki^AyTa52MaKGxGK6DRW?xXMlyV<wOLe+gt&%DXNxdc#4g-Q^dn|MfF-
z3*dRY(Z4nFIw!1Jeh^;zvcNZ-<)$f8mT!pTL}rh7H#x*JD(|LH^Xu@Lz26hRQ-um&
zi|r5Wir~7^6m{|T_dhivMM+4w&9CAb%-cgL9ooZnV2}bM4go!anW*s5{y6tXtV1rR
z?E90F9GtEK%streu~%&_66$$G3{gOJ23=p?nX)lvOhNWg4Suo2>C*l^k1QIHs%pv3
z3S+qV^L&FEFmpG!M<R+huPxtDrmWs9{^kUa|3|~}mvIWAT2O$?cHq-FMVyc&wS79_
zx$o1i=@@#1-R2Roq@$i!F)RG^h(#i1u;an6X2=Q2y=55vA2d|qn@r$A5m&kd%j2aD
z;-uctf*=;+sse2CG&v<b4&|Tp;=Y92iJL#}8Vy!hX2(+?N4&;5gH>y1xW1t6oY!y)
zNzm+Qz~)=J=Tj+w{V5@%D*c@4$du;Yz?qZXLDAi<L0(gdTL<vQ69zU%3#d>zG2zff
zA?$JKi3hWm-5+31qu;q<M1^TGMh&hLJc<VfsLh!M4*RT+&Im5I4K!<?>F;VuRg{pD
zPmQ<G&%aqTid~8IZoFTjz8W&!Ml{$5)YHSM&o5NAqX1izxc4&L!&fmI>%PjyLUBLW
zfwqs=C?4kERm#J0zP~7Me(ud}IepcM%`4)kyId?@XGNK~S0|8#7`)a$2j-B3nM-Gq
z@azqri<C-@XV|n5)H2KiqqziOAv7~O`~Kkz-al+!WE5d`*5d2HspamhK7t|LSv^fV
zz;)<JJ9YGpzNxLi6g=5RTWVOxomIp?`kg}!8TbhM1RbZ87aou((i^AmllW)@1aLM6
zqKl_4@9RpLjo(h{Exc&+hYPC~)I~6*;hMrupf5VOh@<!&XW<p!3RqxEHCM8wtR@jX
zFA;GKI{SG%3OcP#Kq;>5(^`4X&vZYkKR(5kyBVi`R{pa8hioU~LC9;%@B2f&l3pHv
z^Pt@x+OZe7W2S@OAz|}PMr}*AZ_R6iuyYvl<_T-+cKq!;=z+GXF^AFOysflJzhFu_
zeDq0~V+}fYusf<tzE;kqOwLRSs1cyz-#L%kuqf{Wn6UGN5Sw+-pWHo}UN2J#lM6Sh
z=h71EyePW!U1ZwO-M#}pT>3`pY(QY7IAEe5E|+>>;<?v>pn)Qab&`C&w$~E-yPa3}
z-$Qj9V%Nao&>cXeZQ?Q*d1S2?P&lper;*`AT}VURl7K5!Teboad9kLrIQ}ZWCW-w$
z;nd!S=DJM>GL@cuh|1n(8|#bth4~1h<UUB(U%S|CmH*lgxux)x3%Y-sRXi*)=mMVb
zOQf!$)n1K^x&4*HLgrRTRgf|&{ap;0ZoJ$nNGzB-uO!x0adN&Z5VRFs(UY+jF_n`n
zD8hiKzHRN*?ELv5OznA|e=0rIg*fl|>ndxh%Sa{r0x!taOHab((uH5^nPm}$coR0v
z0=E0VGUI%G8kr?NS4{fkrGN~W7xJ$2y<qf3?UteRd?povKDW-*vC<g6$oF7t93a)M
z?T!>UC$UrewyQL@kmnHG)1-Erv<IfGbb#-nKJqj$#13zP<ZpFsl}}wwW5;qTBn*MP
z*LFL-7<lSv8<V*xcNpzAv;Nn_KSZ?mpaAwoDpp{w4?DNYTG`RWnij%^q#DHc=Zi_8
zv6FF?<1x~!x1#);456tH6^6s2Hpfl(RwIUDMfO`Syj;8-HpPD@kFO;Cvl2Pg>g2|C
z+G?+*h*>M1=fxevY?+4X$1T(Rc*^S{gU?|As7vx<w{Ou=i`7iw@X|8V>4t)BR~7t#
ztM?)-eO!YhX96_LMBV|p5j<Pr*egK~Od<m}u^Z8+=u1qg(umk--afO!3-Y_X29Byc
z``2Y!;MW1qiulVnjP@)^iv!{i(T8?gUJ)|D*Iv4f6iNDKBoYlX<5l$xFC+MS<uVxS
z`2C+yaLSO=Qui!n)?;%yVSjFE@ex_7M729i5@n27t&HtVTi)bTVE^qKwV}YabIu-p
z_+dP_O#+tw-C#r4;B&n^q&t3U?(nBMl>TkpzR0-mQnC;g@*ORqM6A8wi3#R*#IM%y
z(5z?uPwV5B8Zvk%t%D_yZOGP8;9B2-$cBU61J!^ay}>NEW#{?<P6dFLWL8L)!LZ^?
z3U0HVLmW|IWZkn(98GICO8IIHTJ{(&!+!E<yPzAb6*$y>=`jR-1H{*ROv}<BgmY08
z+Lz87wImJiZk55;yAuy82Sa<uWq}7TF9v-9bH0BC21g*9)iA@IujBI7P4aD%I&djt
ze)<v%IFg=l=4jSQxcU@PIaKZ!VVjyGs9(!<U12p6C$*}WdbHV;+rvv+z4~j_^u+Ji
z(eyI%T<T~KD;}uo#b)Hs!@Ojqv#h2)>;uD8DQqHNR+<d&jrZT~*6?Rvn+A^j+D+67
zfLxBXpE*^X4?zImMOG(syCDK4p_vm-nym19NkMth#j`DkojZ+K5)~r%=-(O76iHdw
zlqW=AcMn$rk1m%r<@nFv^Ysi;wz|nVyZ8N(pn0>`k&G{>eN+tNa<=EceRXLYnu#>G
zkGg?v&Aw^X+|pg5y7|hFV{5Oy9zHhLC)@9drwx`mxF(eoJg<EdZRL_B=BXDHni}I-
zohoGr8rZqay`1)W6)BP4FPJgd`DmS^7GLvGYH5~|tF@h$WyCsPx!&5~zFqTiD-}lQ
zFgn(^RfOA?>9Bf@=RDLrE0S)^FLo}|Art<Dr_|b>3@zgoU%fdyBpTI(dkpd1#iR8+
zH=frJ+!49k`^*@TMfa*+SZ{Rx9`sPqE+>`L+ID{Xdr>YneayU8&~dFnZ=Q-%25B_-
zmpZ^}d-Mq-<NXLc@v=UuO+8KELhfgBD>QO1Q+C(vgIUR{oI|*6gndUtr$z8Ofk8cD
z#l}CaPSGFE7SaApK;JE#4Uq=EPnFoN&BgxZc7q`cSxVB2Z4pgs(252&$1O0?!W$f_
z8770q{rRTk;YrT{5vnST%3s*X4RP9lb~Z+r9$3oOcu3j<oR~#6dfFs9+qk)dcH6%^
zze|R&qN@F9lyCK6_}54aqxWf8;c^lJ6>ZRlT(7$}Q_->FUog7WGY}Mtq#hlj77glQ
zx_iGe6dDM*9-J$r2H97A(7CJiS>V;C9Xi~zWy05=TN>q`5&@sL%VU+byjZutdvUo7
z(Wa<4gq+BBsQ}JdKd>eh7^~(};7P;68|tm7;<i3T?=L8?i)Jj(lPq0c3-|*89<z!~
z%jHM>QiOQ;-}OHw<Ayr#?rLZAA#E*?;UiPTou`L#Df3snRr$0BptPDr$1G1{8`st=
zj-7|^t<(6Zw)=}VZ8X;OFJjSW2wN2i<+L<p3zeugUX#V@)D(^Hv6Pv4W4%+Zj=sNJ
z#o^;PfJ==@{!;rK?y+qWnEe87`qjTGuJ^O{PQjn9oN1C@l|!ag6M02p%sm{+v27G8
zu~{sa$@a{PMq`&ZIbrxVY>{77qffda()G!1f5$M@nvT|L*a^>51+^2BxRBRRDdaDw
z&lhjn#%b7sdvT(e$OuhW>E}Re6?M{fMBZX|?Nezq`vBorLf&T4$ETZ=Rk343dc3w7
zVhv?Hvgd4BURWSxJg8)gBG%2X>o_NDErS%#g^57^<1pU4?msO{>kNVS?)Xf6dSsn?
zMhAe}78b~{qBFE*#ArQCz<rYJ2Va2Zym{MFLhuA4b{<B$&(|YVxAn?=`o~_-eu~dz
z?b=qurK#)fly7>4<zO01WERdkejPm>^L#SQP~bdU`1J=*{+I%%A|7>4v<fU<WXY{4
z8RdZ}WVugVk7&LR4+6))?70A<i{5+PtIR5<T8?>y2&}d(8KAqoc|)%Hmb)tyP@DFb
z4AE~gdMt~e1ONQomV~oCyPHhs+K-;8PmqpZ=6ugIdocwS_HnNDbBvMmr+#NW9Hkvu
zW1BIqxYj;<_`8vv@b)v|la5#lIrh}o<${N0eo+u`GL~f&UKYB9zZ2&;f3yFuTIvqd
z$@=Lndxr|YJ&9X8M2NTY3Rd)akd6afAvJ5{A~<x>5%eWnO^vaq*fF2=Ti~g+nPtc9
z+HXsI(K)MWAil-A<y0)h&!VL^W~%9YSJ6!2@(am3$4>+UgWbJ=L+W2?Q7Y3dGwq%%
z;*pcC62JRN9<lX3wm+N*Id9M5V{PIxI<MQ+l&LL3Q)G67#F?(k8kFapVL0V~ZeI)h
z88i{rjMDHfpx!SYW!<8id2J}RN8P3`<aMP`w?Beu_TmFc$>LrF_630E+1K-?9!`=W
zt@TU-wHs4fNB{O@`L;~p>?PpFY!Jnk)0j<LSF5A1uLTJlqe5z|r?t#%&IZM8X&u+!
zL%XwrAE)thpG}<=+=hOc@V$oj?D1*g(~w#4E3*?sK09P`(sha5SY3<hvKDq7Hh4Eg
zF#RH|m(Y(p^wMUKKMltjcFpL}99riD?o%|gxh|%I8wCdS#5P?zHHT;<2)qcpkK(Y$
zc=6^VtqPCcbM{PrWtJ*E7um`DB1mD}rtNC>b;ZKEkooVuj^EC@C5v|ZN&18Vj>}Ov
zr}dPzls_0GQVo*;T=g6co@?CrfG5G-S=OIa)VPoOAU(_^TBYz%?+~r#Gw8}l&xVkB
zaXk)ZZw|uRJ0^0xpV|566qEA@0ydQ>n$xwSMIVH)`usc}(W6p@Y;dH7eIamQ?ol7T
z)Smn^+RyqS<E%JE^3QECQhO!EtyLFxUs`EwQh%{e*)q#a3j#{A(MB+dBjis!Dr{$J
zOctT|gGD=^4z~R)?uEpEov0fM@4HFd_zN%;vDafaSh{|A9?sbv=64rpKy=LwH0&j-
zoUj$UsmOdv1$x>wE(v+|>dl^}?VX(tG`)Jp9L1ztf))dyE!@HvD*Wm|3?$=Jvl;b=
ztYkb!M^{+ic60LS+8U0ZR2V%rmPt)y6lEhM)LT<ci1ybsANc+HRHbuz=~Alc1$<Ei
zbQ)-XTgBTv9KUz=oI{MiX05x)<)Sm7uougATJ>uLX<6RqJ)d2wV>vGslfER+PkGU>
z!<{DFGo|6-tBb45rL0wQ<dBWC#qq(&g~k4tEZq!#I>zC6M^FOVg6(S%+Pn@+mgDax
zJr-!8`r*KhyzhIHByI&z7Vy$aun*tG>vX`Xns@s7P?|53?KFh&oYJ@MIe_*1)I?kt
z6RtnW)YDc`vrp3^?=!z#{-OP1%f<kkb+0fPy?E_QKPa>A<02;{JEel4>%bLfx{295
zy>b?bF-4fFaqu0E899#SI}t|stmtKF3=5jTKQnEk&jlA9yLuNiW%Z<Maw&Ie+7elY
zNy{o`j^9@*tkbO9AlG)`2Wj+?e*?b(@P%$H8kd6IVHWBDA8%e;R_D1u-M+<f-tksh
z7CfWyt%zA0bm8OiL+4>D+m4>=ES;a{fBOPE_qyly@Yt3va&Yip2CfDRjY_6y{C;*j
zTls2}MEf%fzKR7tvocYN_48Dm!yS4XS$ikWy~Iu~lS!`+w0Ck3aQE;E#P)Tk|EK4Q
znOw6@fHf!y1t$Ogq}^VHAQ7nnIwcP6R13yP!{{aP(6(58FU=&IKHQq__5W<{d+Ib_
zTarJPNmzyH$?P?}b>LH`K9U(AZF8$YMueQjIfCS5FpA?oE<c~vcRCzXC}k;A^!dhF
z6GMFXbbt>VUWAN4)kxDn3go>XINnCiDD9tuHNNe+s>HfJd>hhu%#%|2ss5_yx@>Md
zGXB}t+lLxwwLE?I1Sd?c4S`a%Ptl_basD+T(WWP~9(lsmw;5yNA1QVg*Gv_~06dI`
zRXLX4v&`}7jF9P;-{n0&`CIczrqt(f#I1hD%|Bbv8&aaqD5kM;jS~N5<4)YKlqJ{7
z1gLc1Mt8c?=}!Kmckel~_{}+tAVtdN(}esSPQV;PD&1zEOF;t>$!Ygi(-0fl{kN<}
zIRsoE{m`(oWqH9TWQOy>O0l9pjQ;zkoCf3EeRKu+baPQeI#yot_*)-&c9b1iF{`j)
zs&c@<HzKEX7R*iE=YS#g43Iy)!3*~HnJk_j`tpza4V+he4!rj-Zt4a3e~`zg;&)}f
zEbT6b^W#dw8#3GV6mG*q&${6n)AXCH27;F$(u-mtHU366<u?Z{N6y3kNi?G84f!eI
z^J&)D;kMvs9^qzhwxTOS1u<Kx9N2xC;gy>@D!#zLmm-B-Y$7TbUV4MI06eaJyeRwG
z4bAp(98`m|C*W?@;L#SdOkpVBMk5V7n|a7FFo@zcSj)6Co!#|G|GA@3*TWG;;|K9n
zd>%_j9_;2uD`)Hq?42hR?VTral}>dpFb@j+Do6cCjA}~YZDb>SL%DgOqx!w9%KZ;Y
zglKgPc=G3?c1$4?r_uWd?VE$>7r-o{!_?TR%J4yTAI{!G09Yfc+id=3=~S%qq;Af#
z{I3$-EALewIwIb9lH0w{N+XzH52E}z$`|_mgg)$N^<Hz9_{-LIoLasz0F|Ao@#jw8
z!4_c#)dr5gsSBtsh`=}^D}?p2J_m_6Fdw9E1x6<Q51sN|e2?vy;hOS1{ztgi{3lLF
zd_(lH#rK)?Q(`Rcoq8`r$$86y@aH;Ozs}!ef?`VXR*G6wPDW2<re29^e-0b>iE|I%
zd>>`+Zp3kmv`F~DD5(;x8z)<3)1YN`+Li1CGL5!*eJ!8T{_y(UGe<|m_3<;fUzSV#
z1i^mE@WCDLYMbt~p<kT;wuuxn(%O5Ldy1kW-k-(&C-(<G)^~&NG&q^l$3SoP$vJA@
zSgABR-&%!f+r-+sBiW2cXDN7wKu>7SyM|gDP@O$p(Au{ZrrhBK1NJEg4gfvz6iL%d
zt!E_r8uxt7Q{-k@4Hr(C?Fr15)-`p+MaY69NC?{sAn+R1$^CfIHRl&@8*(Oq;ZkcL
zYnt`D^yF{2d}p(b%D9Q9vaLb+G%L^{tEaHe4Swi{d+v529aVF&CNfK?O#t8^ds-B+
z#rdRX(0B4m&)Jqo+1jEbe^#e4Im0LrsB(S*aqu5>Jl&qmatQ<qEfQ)I0!TGTh;Y}~
zaC^>yK9nsdTJx4&5EDJ9Z1*MGH`p#*-)bugI0eK~-dTW1Ae?cTy3sCGo&y*$zT4y;
zQu}{1--<2T(KDbz#&f?^v1Vw<`P^TV*-N&<*G=u@!$&eV3TtA}&Mvz2+Tc-Pr{4}z
zf*%izbXFsugnrbG3gLljLo4HiVPaZkR?|^r5j3tB<-~;~Iv}0A3+5rUlf3nF8)up<
zD?g8(c_{xxt9HOf8x76oWce^Y;5DA9?ROvCFdoZ_DVbk`>&R)h?>a2Cr!K6w0Nits
zIbr0H`Ck_gFQ=~uiKu>MD>-A!8~^jba>PfaQEe3_g+|T>rc=4=dG}|8#y>9RD3P>~
zZ<?MELyjg#nfVeJ@*YP?)Y+T;@oq%w11RL%cfF`c9@%nHm*^D?2F1L?vA>Z;h*aHW
z@;&HqYEKe<Q{pAtLh6zzxA)RD&F<r`oUp-B_Q;}k%5fjC)fzn^*PGg~hNKx$w~tB-
zli%acApAhojOd-$%^c58Lrt?TuAoxf6uO;oJ;#ZmKGdn49o3rILiKMjx_8L_=sUf2
z;}V#$8B{XUJ<40x6=ICtUP#~#Gcy-Y^_d3rI%_*P(#zkb33&+z4AR?hOzMuU72cq_
zx+bd}A=K7r(E+!Uxr8p~t*^H&8$nKzEr~iDUPd+O_l~}V4o5+YSF$$G;j4ZUDs2o|
z^dQDonDJ6*Wmks1jbcm&{^q0=xxT<djqm%LpdPq5RAj%xAb&IO$o_R`2Cl#VcHm6r
z8dxCw%fwRPt83@IxGL^eS(@{Rsi$joLRwDJckcHEk}6wu@7l!n9ApAB4|%IbJvRaH
z#zX$|O3d`>U!m3-2Uf=dTQOU5;1(~V$q7hMH*l=fvl4m1*{D4$mkzqFw3NN~IpMs8
zFYq?W9;f|vTy2|^x#udXP|kemU(o@g9L=(QqSNW8Nc&D^xMC3fT4v43yKF|-s7Yph
zz}U9&BY^{Wv;0;ajkNNd?qEFmOVlO;Y&q&*w1i@k<A>a?LT}lq=R7ig+Q;FM^6S~k
zL}I+#(v5JpWr&L7;~UOO7Pd`|J0Xs|22hpN0@tDu|G5L(+H>Xe#p^MXp$u@WFkGyI
z-p|LYV~D1Wf*172Ck{zUxU?Q1?ccwD`Z${&AMhk8oRV044|MS$Cw%^%bVzSS(<3_&
z=G`7+V{uY&0TI$!Q>WExwO>dIXf_%a$EqZ#6`(}FJigv!?<KrSUtu+=+7?~6ji{JS
zA5rKun-vu~S0?X&HDpaQ!BSntU6`20QZMKc6?mh6_C0p8ZtxOmS?UQ1shgg&@NuYe
zy&s)p#2F&L)G}n|uosUU+#T<s^eb$XHT!xpFMjSpW~&+Jv08+WAq@8wV!-ooq>rpY
z!Zz|A&NFZ7oJ$OkGRJea&X9hkfJxIr0=}W0TaLTewDICVA2wyj`$Q2%v3dgdpWKYM
z(Mf{wM*7^*P=uo&$MEQhl`=KW$++Jhyqm&BcfU-y|F8(7Hc7(s5EKvkDk$-+_Zh#Z
zt3*fK=7Pw13(mNGx7A6xm0k4g=2|V5zK!gWHOYQMQDa<ZOv{hFNfYg*0dJ4#m3(qQ
zd99%5%KoY@*hFx7(zoTLo&bP$$=sn|9yb_MHAlOIEo7p?!xT$J`y!|(Jwmg!js3W~
zPP9?_{N`w~3c9~xE#)?3b2}m`i}baa^HSqN>&dBN8{fwaT$6c6+O|b+I@oi((L6bo
zM+6;)`Z6zwHhS|VAIFp(Z3ulo3Rb~~laxOG`YB-6g-1lR{)6<f5InW9+#ay>O`K1B
zao#zrKwQ^pf5f1#s+myPsx>Vy-@OM(4SH7ko8M|93Ztrl_E~Y%ix-ah1g6z<#$@f(
zm1*)6KKIo>H3$`JgHbrmmZ>TpI(9N_L|r~$YLh(PgJ*Iv>A6!m=Y;wyC%$wxy>b?K
zU>CCC@!W+g+O7mMfPD_`)w5f7?#Ess=vs?wxQMRI$`U?_X1};CBgo)WtaI#&25}L6
zRa5=EW$4TIT&>pAIpTL3r?TI8zZMZXA>WN%&5_qjtSgiLf{v7g%(-D3u~4TW#r66i
z!i{O}fvQ_1O)Q;(MU};6g(GN|ePSi3(CFHQe@9(hf%@CKN|uA7*EQ%9d-u5~K|r1R
zJOsmEIOf^Y@-#myu+6rij=V3M)k`Q}JI*~+oa*3P=hJ|d(@1Qpy=t1DQ<#ujgZ_g_
z6MikO%#4dKy;gKqb{ppbm2wgdCzI?p&X|v**sIj5*sYv0F^}vEdgXb;K!DI^S=Wk-
z@doH-4x;W9JNl~Xrp1CHCoeyO^tRp+WYy4Q{W@EB%5fBZFW9SQyB-hc*s-ybx4som
zBS{SUPS*+A6L{1WDOQtO-c|Sgs4oSYq&8RUtWOYd*U0!VCW`whjqlc#eU4M4w!uea
z`8T8&^8&umVTlz$7(;d)Nb%rRnLTWylwx^N>O3xF<<D6t5Yt;v0a<*U<1I3WT!z0f
zFrdb9xuYO)?r8`Wn7CHF%<jaeMw2P~RUlq}T<ye`mWAteg9dQic5a_rpPH9#o!V1s
z(dUEN5SjGuQ00(NB(HVTK0c_BI|Wj&0-o$)eVV5zPbaTG-m0|aZwyK9LBD8e>DVGW
zY!7*8>5FnPa3}N&X86NX$_%c;-2*!d17w#LlSC<!=SFBHP<uVWd^9&Yd+U|t!$1ZE
z-omjkjb|5ssl=7#I$s}R&p!|Dq<AlT?d+H1Oh1^{y}|8k4IX#X;(GUHG9l{GY&(aC
z+6LX3(0=r?fZa(dGl8N^`fT%bBpq_3?W6~81anP7V0pt_$A!MT51v>pN4wk2+k<DK
zW1iYF{F9_R-3hxL1OTP4!k@US641;RL5X~5OKRzAo#WKfE+T`7sB76<*3wvQ+og5E
z{yYk!HNiCP$lJcA{Jmlab+OW9^4nMm!R|J=e2@-t4xHz8YR$BO(I+K=IOnSFAP1s`
z{FxM{8{8CFI#GHqkI$O*LcWk%I-oJn1%pKeSo+~LHnnFryo=|15NUHS(<@J|-oe}W
za;7HvDm_0?)g!7C0X4gQ9ti3f!D-h;&sFiUca`q4bM?y97uy!?Ct1s`QzsZ8bH^Ic
zD}So2ro*nxhKB0|h&UQ7`)FXNsB}PAebwf`v?G$6MjB;fb%1jw2%uiT_%_$+$2S`1
z#aS3<8F9-dmJk#So*VJ$D!b0XNA~*<pP<t(h#-hNV987(3|(g%260(E2JXYo=}-!a
z@yGyydj4UkM|>S{F<%J!F0(;OijY{ZW8hoO#>o%+s%UY=1r_5_AvvKELenX`(a;<7
zw&^Rm8742#>EV#9x9mpYiPn;9>d@Mjsh-flCTyc&QD$r^FM~91vWJAkZ?J9Y6Aqdg
zR<QVa<iivtKz&Mxv~wRGyz_({jJJ|dnaf~0wLgOG=K!~%4IJkf)(xmAZ$9%rfmR<)
zs`cZgf_DXeYImNGEfv>&!L*GY1*L>7Db=WcJYS-&ksYEA+suR~bL-*>q%E%#>M*yw
z=*`XQ?g_GnLA$i|j6y6u#qnaJQ(iB`9gQoMrSbi&HGr4z*p3dn_UNq1`%dPBG4j1v
zHy&<cCj7Ba)Gd^`z*|S0ISB%rCLM#;%n=r=#vKk-RU3Ntu6RR}B06h9TD&0X7D4iK
z!Fj8ji}SMy98=^P((TTE`z0Fq6W8{DKUZ4_cTY-(2{Q3GeXJr(G}pS?#kNrq7B{8;
zST@Xiv)q-jzSBM2-QILz+TlNpZRU3^Qp$5>-3l#KgI(=$ReKR@FfuXbx_GZeujGqy
zUQ%b$U2{_E)8M<>vI8s;p<eni;q`{HJ}tR);`-(GO4NCaL0)dl#0+)~LR!mlzEd;o
z`$FYf1nFGePo4Q_Z0V`bqAr=JZN$?<M`5au;~$?gim>%`?-f7I^G^}HDP7ftu0E&0
zuV;3!aQK#WDplqNUJv(J$gG{}$>*5^gnzg!NO8-E`fv&JaeT))6$6NYBw}twrSODy
zWBcv)v1eO9r7z|OUG9&@0Ou*)9M2z?9YO5h34?CVY>#%cG<{*e%loKu5<};SC3pqf
zWA9j%4Srs!>HiHauRkdcXvXn(%j$_cY^030Z$2EHygBmUY`73|5+@bBvGuT$y02bf
zI($w^6qS$PJyU})RSj?musEm)@NqT&PUOUyNi+)b=CMeFY)#LHc~LgQLXg|O_A#TD
zsDR$M3=ItbHk-h{j=j0Ovskl)%E#7N8jXjYChr%6S&j(i$$7=Hy5`s7_$udM50J+D
z3kqF5G^)%GPwqag2mW4Rd0VGdyKSJB@=`gtCl5^jm+7q*`8#3)=&&kg6#kq=qk^xn
zuQ6m+;~}07w(62@@RK|1_t$PSSe{rmfv8Q+gEl#9Hpk_c1R@iDdOp;GcP;0$qOuP2
zs1!`g15+UvI+yx`T53))@4~Bk&D|s-n}c2JWb#^+ubn{(b7(zNz-s#g<&*VOi%yQ!
z)k>c!)V?Ir5fuN8k=*}v+Ne7#x4(?pd89B+0BLe}MHrpwx!wD-8Y?t`c9TgJuDV*n
zCPg1o+Y0dsfqr-h#f+6lLcN9JLG`gLEwx1LthZsv)+hXOdQj~)<I-F7lWr=u7OZhO
zgFe4WKSI%!!&$VtvOBFEaw6@qfn33j`Z;OiMKVmjIJXZ&37*3q6b_D=N)0}#K8-nm
ziHIrOX-|W&$BrGk6$@9ZL0%e~JAibJ=}A}giZM86Rdyg1fAfRBuedwRxL}5F!Jup^
zvnKEgN>`?9$4qk^#_;ZNS=9T{G4^L@3xd7d=Abr(<>K|iH*-M`{QhErW??5G)S)5a
zI1*#*%Bg~EBF!jja&r+`<}BHgir*b^;by-DCu8Y;ZL(<!t4qi4k<pLBzq0bEj6GR-
zNXnvTiID9_T_>DV;8B5Ec9gHCjJ}C_m`2?iRvZ0rtl9lZ$>47Eqgk0+Ko_a^B;S*k
z%2+R=wgiTQf_pCLW$nk$A4p;k`l;1F|0pWNw~Y0tDyOQnrL^GdEA;alPb=B9Smqea
zgVU1cS;!XTiM#nB;AHwyft`J*IE2y!1TK}<&rMbJ-)Z&0=vfF{`)erjU|Xh{2II#S
zJ>`hZ$*=quYQ8G|<NCUP)N+{a^ngXFxTkeGKN!k`@Yg!|Ypp99VlNIJA}zt4k-khk
zCG^Fka_ME_K;<ul8xv6-*V&Gtkk9}!4^GSAHxMUT;~+|HLil8N6tTA^ZA?H?sFd9|
z9Pz6%>p%frAtxPlrtYv5;rU<ujs!LmKRsbb;XvAYAnlMPzo5$9;+4;}*bMXhek#);
z>etsVRURANuRZ~x4FG%_@ZS?jqk*vDbk6b|{F@a}68p-02tI72;plg+$;t)CjIe~k
zx|go0i$5iAC#?4+MgW&=J^_&z)5*DM!4)q&1Iq@Bifu-|h4UdTQ_Z%*f4ly>Z4{OZ
z%+>(d^?G(q{6@i}L8W5b_T+>9Zrjb$cUx@KjkTW@$czr61KU-e$Yo;D)M3^sE7~P5
z{kEM9)@bb)QSgG93MbgM2@L(Sr0B$ODG^M{$aaWG^v?%Z7aq`UdaU_iJk5I9h$$IY
z*Fy7<3&vdy4~P<QOAi1v0Gt6{&^r3Esg&mZBz*X!blj)QjYQK=;f@gp9n^trQqMP@
z-?ZaoL1#vmax3`X%#Efn&2SG5kX;XURo)y9n0J$!Y$2rg#D6ZQC2#JUq(po^8(6w@
z8tPeIWw_WI{FD3X>3k<ioSAeWs6l%}jEZEJyWhJoiBFIs>`>o5GBOXb?qYS(Aov@{
zZzr*TxLZclA-1Q}r#8$ILU^+TDoE!&b8ucNy*w9$kM{UVw{QQhZ;IZf0o!V}JoTr{
zn{*)C9CwC`sbvu@Oc|&XSR4LcgC(ym)ILZLvFz~z&N)_~TrtdAvk4gS80W{~yTaj8
z>k5sYP<?N(X<ZLaYo2g!ZJ$;eD^Pd67I|^5@J9J%+fu&i*B9T{R=bA2#dS`04qi{B
zenv0fgf6Ay%Q)IQXEeJwi#-@9>8!8S)e(8mrRZjr&>O8~!01USp!kNvP7J4?xkx%_
z(gOH5m5@1~+fqHhz8i630Y=gt`tXZIK)ajvsDx~rRx%3*cbamw!pSoETdX8N1>Uuk
zHIy6=S{&3vaqu6GAf^cI>+>#gX1D(Ouo_r$X3cTjvG-IS-^s=&eMk&>v;jvHgQ<0e
zfmrRYh$x<2kQRD*>!>@zCAvDMN5=WnTE6p+-yhWe=y>D4&-BwtYDYuf%UmziuSnN}
zR*1jLo5-v3y2Q$ZF$?~-$j3`TQN69=xv`Wu5nE@=D%S_SRwCfA@A!I`4ORqs1$fz~
z&N!b(dA&eKdCA9ZK1Y|3Ff3=QbBBg3EGoksy#B|8W;8bHERi2lE{aTnnvfQ;gl0+)
zuy)9#c72cS0YoIO{qb^~bb*CZ6TGXp7~WAb^YUx-5}jh*q`Q`JUC7;f+NN(K+33AX
z)Nxc|<f#5~$1hlwFB7?>p%m_oTa>7REjm$L#JMP&_52D-$?6Xoe%nlg9Iu`E%c4QY
z|5^D^9;s8XNV1GNuSfSEa3+0md*=bY|I(i4UOS}jz!v-U@#knG%d<=2Ps;<eqb!<=
zjh;5!f9D!JWl~|O<D9&EE2H8HuJ4M-(`qdL+UZSHI(%2PPREVDP@TL<9?7~wZgMr9
zcuoeNq{e*8=W?%j)1cxf<Fd4UCOsrLCI4G#FU*f)b__X{)RW_3)KHOQS>`g&CsV&X
z(7IsP7Ext|&VM-h{BqQvD1F_;Xv@=JMGCF5e5RM45=z)}+SM>w7fP?uSoe~WWO^)_
zx{rCl)NBH-t<n@L9+hMN?2$N`^Sfbc@YJu1>M(*W*>#Yqc|BBO{I=+$!KiH1rA<xr
zZd~`UzL_GO^*|;7W>_Lm*xR>2CK`(|dVir{<mbOVDA2<W{;{QL7~7?PR!r@47Q;#u
z;{Mw6dPAGB6vy$fMuh<W>-Vz3{$0g}c<>T^cyY5}kv8~g^isNcKpRG$pSNwB-|q0a
zOr(#k$x#5=^!xUvnDZ{ZuMgXQx{q|}3(y{8O?8&=DjTaVQ5Uc{q`N3qdOp6oXu2V7
z*Sox7+QW;v@+<3aA{`;Kx-Gr*-yU^25SKVF>$ZtXhbV<uz%W!FffZlrd?B!stAcjL
zt@TH^!O+r6?1h{ZF0yk3sC=`oi7<CvwpSnO*v*CYp7r=n5Fo!H!u{I36&~aF@?JuT
zz3srnq4-+@14PQ+8Cs4~HjHSmxJp$JMEPqZbT7A|Z{ugOX3S;oBkT|IoW7*1ui)W|
z-Am|Zhsn~B8d+_5#ngsboon8|MszMfPEGHcl297QW7OIs!U%L+M&4zIfr40ZyUWGY
zyig|-r#uXmN9iOQJoS_#RYn)d4;+duHvwyh+u)DC^ifKV#yyQ~V%AER8J$o=jAytX
z*^Z-8+Mi4|b0Xc6_P!3w4nL7LEHl*7B#6>g9fiIn>q)>J@K;Pjs<0^pzQu}1sVlj>
z195@$Sjv9$B8h^rry=>I;TkA~S9%gz2`M+b>hkG;dZG#2i+_SbRblp-J>30=DVXT;
z9+KU^05!H7sBZi*@TN!LC9p9G1LvRiN%CCb+8)bB)xY_n`=JblXK2@Gmg`HlKf=po
z6xW6AI2JWlN~RE)k2~S?Suf?gI}9~Y{>~_n>p#`&e{wpl*(8kr2}cZ|C_j*X?G;{D
z)c_u5DKcCsHe(dV%+E#DZ?XJQgG(1uF(6i~@_!c-`3v4=|G&hx1|_;k)2zHxL@&ZX
za*nd;{7S|MM2+E*)_hFF(897g)=hld{7-m94XOfZ)vCAWOWq?Wekz%N!43YG8iO%h
z9o%i)iS}`1$)dV(0Scy8seYAWpiCgO7nl*LgKLM9$ShfOu>aE){?qgdqm(BZ<E`%l
zlmc&(E~~y%EGD2FD(WU-X#RVSQU!lRIb;6<P5FO}Y$&x)ay185DJko};EhB6`6$-o
z`RC*2tVQMrhy#m&4K;Z`juY$t|2=J}_gvTlsT2brCnTh_KC9xU|BIYzk$tb1G+QcW
zDL^SSS09&Fd!?<Hi1eHK3KQ-`<*i&!l!Xn}ZW?g+l(Ye*E&k_E4h2`bRJZDXVq;b;
z^?yOTd*d4X7mZ{-%F(OIGM)d&TJjHTlNeU{e>fP`QK7`yXqBlmss`R@8(?&osTQ<L
zpyGvS{V$ko(yM=T6xY~&MO`B4hZpsw#xxP*7R8ZzmA$?%|0Tpp2W2G;PjyG}pWvAl
z>jD+5W7bq+38@piYMYF^q835HHx&B-nwfJPSU0#6Z6&kQ#V9Q^2g*^udc<#MFh+Bm
z-@%aQ=a;xvY~0x>vY?Ol75s;BMHv<0qHg`idmgOa`K4Z5pj$GV>LUPdKBl!|i0g#8
z8Y*Fl8BKd(*rb`MzJikJ2*SCv?q3d#jr^FhEU9<)B$yVs<VZf{!fO2|x#rS>3mHMs
zp0`r_PbXD;V^PiahyTicinU6BrS&{*)W{iBxql}Bl4Zt2B%`u*iP)v^tif3L5kdWC
zVP$=4z?eoV(y&wMfIHYCRsbbbc2Gwd@YaCgLKM*tUwC3&^$NX>NlGK2XbEHY=QA3n
z@5P#Ga1UpP`nV+7v;B}qDO{6Fs6&_&G3EkegV=~G$$uVNH*k23Wc5tkwJ+H~x=Y~d
zj6tZZzyFfM&7slm(~kM#JWeu$9xbIUOyhU#Ud;n#QF%f8XH@o@OY}mJVHlZGH1^KM
zBa#iW(+&-?@9NjuKCJ(~`cH|z!$JwBKhN`LeM>;?JLFW5VsUN0qCu$;n239KvW0in
zmiX+g2iuF1_P<j1h1%vJ%7Q1c`;C#vBou<B(k)jzE!rhu98h>auhv(Z(2*hGo(ARE
zCoe|3I$R`JJ3iq0Th`>GxxLoKmu_(gD#0~30Rp%Cfski{E|eN#Ob^tV`WMC6zyYJl
z0f@$ImNts#*VMkm9Ruii-zQ%-*V$X_YQS{$(;~(H3I2rd`+U^V_g3|AcJfC^4yUML
zY^4^^SIG1aD3Vc?s-l1^l2THA<G*{yb|`B+HS)izKouqW@Qbq5`dkdMaY*|kCc>1l
Xdh*q4Ce(ifK$DkN{#5?a`1}6>>dkqL

literal 0
HcmV?d00001

diff --git a/docs/conf.py b/docs/conf.py
index 54b188ad6..47afeb308 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -110,7 +110,7 @@
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-# html_favicon = ''
+html_favicon = "_static/logo.ico"
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
@@ -130,6 +130,8 @@
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [("index", project + ".tex", project + " Documentation", author, "manual")]
 
+latex_logo = "_static/logo.pdf"
+
 
 # -- Options for manual page output --------------------------------------------
 

From e91f873a987125f5dbabb910954f24e0a2006fcd Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Thu, 2 Jun 2022 10:23:00 -0400
Subject: [PATCH 07/18] Cleanup changelog

---
 CHANGES.rst           |  57 ++++-
 docs/asdf/changes.rst | 475 +-----------------------------------------
 docs/index.rst        |  20 +-
 3 files changed, 70 insertions(+), 482 deletions(-)

diff --git a/CHANGES.rst b/CHANGES.rst
index 6195b86e6..ea9e5ca8e 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,6 +1,8 @@
 2.12.0 (2022-06-06)
 -------------------
 
+The ASDF Standard is at v1.6.0
+
 - Added ability to display title as a comment in using the
   ``info()`` functionality. [#1138]
 - Add ability to set asdf-standard version for schema example items. [#1143]
@@ -8,16 +10,22 @@
 2.11.1 (2022-04-15)
 -------------------
 
+The ASDF Standard is at v1.6.0
+
 - Update minimum astropy version to 5.0.4. [#1133]
 
 2.11.0 (2022-03-15)
 -------------------
 
+The ASDF Standard is at v1.6.0
+
 - Update minimum jsonschema version to 4.0.1. [#1105]
 
 2.10.1 (2022-03-02)
 -------------------
 
+The ASDF Standard is at v1.6.0
+
 - Bugfix for circular build dependency for asdf. [#1094]
 
 - Fix small bug with handling multiple schema uris per tag. [#1095]
@@ -25,11 +33,15 @@
 2.10.0 (2022-02-17)
 -------------------
 
+The ASDF Standard is at v1.6.0
+
 - Replace asdf-standard submodule with pypi package. [#1079]
 
 2.9.2 (2022-02-07)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Fix deprecation warnings stemming from the release of pytest 7.0.0. [#1075]
 
 - Fix bug in pytest plugin when schemas are not in a directory named "schemas". [#1076]
@@ -37,11 +49,15 @@
 2.9.1 (2022-02-03)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Fix typo in testing module ``__init__.py`` name. [#1071]
 
 2.9.0 (2022-02-02)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Added the capability for tag classes to provide an interface
   to asdf info functionality to obtain information about the
   class attributes rather than appear as an opaque class object.
@@ -67,11 +83,15 @@
 2.8.3 (2021-12-13)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Fix more use of 'python' where 'python3' is intended. [#1033]
 
 2.8.2 (2021-12-06)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Update documentation to reflect new 2.8 features. [#998]
 
 - Fix array compression for non-native byte order [#1010]
@@ -93,6 +113,8 @@
 2.8.0 (2021-05-12)
 ------------------
 
+The ASDF Standard is at v1.6.0
+
 - Add ``yaml_tag_handles`` property to allow definition of custom yaml
   ``%TAG`` handles in the asdf file header. [#963]
 
@@ -170,6 +192,8 @@
 2.7.5 (2021-06-09)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Fix bug in ``asdf.schema.check_schema`` causing relative references in
   metaschemas to be resolved incorrectly. [#987]
 
@@ -179,6 +203,8 @@
 2.7.4 (2021-04-30)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Fix pytest plugin failure under older versions of pytest. [#934]
 
 - Copy array views when the base array is non-contiguous. [#949]
@@ -192,6 +218,8 @@
 2.7.3 (2021-02-25)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Add pytest plugin options to skip and xfail individual tests
   and xfail the unsupported ndarray-1.0.0 example. [#929]
 
@@ -201,6 +229,8 @@
 2.7.2 (2021-01-15)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Fix bug causing test collection failures in some environments. [#889]
 
 - Fix bug when decompressing arrays with numpy 1.20.  [#901, #909]
@@ -208,12 +238,16 @@
 2.7.1 (2020-08-18)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Fix bug preventing access to copied array data after
   ``AsdfFile`` is closed. [#869]
 
 2.7.0 (2020-07-23)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - Fix bug preventing diff of files containing ndarray-1.0.0
   objects in simplified form. [#786]
 
@@ -274,6 +308,8 @@
 2.6.0 (2020-04-22)
 ------------------
 
+The ASDF Standard is at v1.5.0
+
 - AsdfDeprecationWarning now subclasses DeprecationWarning. [#710]
 
 - Resolve external references in custom schemas, and deprecate
@@ -307,6 +343,8 @@
 2.5.2 (2020-02-28)
 ------------------
 
+The ASDF Standard is at v1.4.0
+
 - Add a developer overview document to help understand how ASDF works
   internally. Still a work in progress. [#730]
 
@@ -324,12 +362,16 @@
 2.5.1 (2020-01-07)
 ------------------
 
+The ASDF Standard is at v1.4.0
+
 - Fix bug in test causing failure when test suite is run against
   an installed asdf package. [#732]
 
 2.5.0 (2019-12-23)
 ------------------
 
+The ASDF Standard is at v1.4.0
+
 - Added asdf-standard 1.4.0 to the list of supported versions. [#704]
 - Fix load_schema LRU cache memory usage issue [#682]
 - Add convenience method for fetching the default resolver [#682]
@@ -344,12 +386,16 @@
 2.4.2 (2019-08-29)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Limit the version of ``semantic_version`` to <=2.6.0 to work
   around a Deprecation warning. [#700]
 
 2.4.1 (2019-08-27)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Define the ``in`` operator for top-level ``AsdfFile`` objects. [#623]
 
 - Overhaul packaging infrastructure. Remove use of ``astropy_helpers``. [#670]
@@ -363,15 +409,14 @@
 
 - Add support for jsonschema 3.x. [#684]
 
-2.3.4 (unreleased)
-------------------
-
 - Fix bug in ``NDArrayType.__len__``.  It must be a method, not a
   property. [#673]
 
 2.3.3 (2019-04-02)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Pass ``ignore_unrecognized_tag`` setting through to ASDF-in-FITS. [#650]
 
 - Use ``$schema`` keyword if available to determine meta-schema to use when
@@ -387,12 +432,16 @@
 2.3.2 (2019-02-19)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Fix bug that occurs when comparing installed extension version with that
   found in file. [#641]
 
 2.3.1 (2018-12-20)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Provide source information for ``AsdfDeprecationWarning`` that come from
   extensions from external packages. [#629]
 
@@ -407,6 +456,8 @@
 2.3.0 (2018-11-28)
 ------------------
 
+The ASDF Standard is at v1.3.0
+
 - Storage of arbitrary precision integers is now provided by
   ``asdf.IntegerType``.  Reading a file with integer literals that are too
   large now causes only a warning instead of a validation error. This is to
diff --git a/docs/asdf/changes.rst b/docs/asdf/changes.rst
index a9ae82fe1..e89b1f85e 100644
--- a/docs/asdf/changes.rst
+++ b/docs/asdf/changes.rst
@@ -1,476 +1,7 @@
 .. currentmodule:: asdf
 
-*******
-Changes
-*******
-
-What's new in asdf 2.12.0?
-==========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Added ability to display title as a comment in using the
-  ``info()`` functionality.
-- Add ability to set asdf-standard version for schema example items.
-
-What's new in asdf 2.11.1?
-==========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Update minimum astropy version to 5.0.4.
-
-What's new in asdf 2.11.0?
-==========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Update minimum jsonschema version to 4.0.1.
-
-What's new in asdf 2.10.1?
-==========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Bugfix for circular build dependency for asdf.
-- Fix small bug with handling multiple schema uris per tag.
-
-What's new in asdf 2.10.0?
-==========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Replace asdf-standard submodule with pypi package.
-
-What's new in asdf 2.9.2?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Fix deprecation warnings stemming from the release of pytest 7.0.0.
-
-- Fix bug in pytest plugin when schemas are not in a directory named "schemas".
-
-What's new in asdf 2.9.1?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Fix typo in testing module ``__init__.py`` name.
-
-What's new in asdf 2.9.0?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Added the capability for classes to expose their contents
-  to AsdfFile.info and AsdfFile.search via the ``__asdf_traverse__`` method.
-
-- Drop support for Python 3.6.
-
-- Update setup.py to raise error if "git submodule update --init" has
-  not been run.
-
-- Add ability for tags to correspond to multiple schema_uri, with an
-  implied allOf among the schema_uris.
-
-- Add the URL of the file being parsed to ``SerializationContext``.
-
-- Add ``asdf.testing.helpers`` module with simplified versions of test
-  helpers previously available in ``asdf.tests.helpers``.
-
-What's new in asdf 2.8.3?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Fix use of "python" instead of "python3" in compatibility tests.
-
-What's new in asdf 2.8.2?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Fix array compression for non-native byte order.
-
-- Fix bug in schema loading when URI is claimed by both legacy
-  and new-style extensions.
-
-- Hide 'name' and 'version' attributes on instances of
-  NDArrayType.
-
-What's new in asdf 2.8.1?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- Fix bug that corrupts ndarray views when a new block is added
-  to an existing file in absence of a block index.
-
-What's new in asdf 2.8.0?
-=========================
-
-The ASDF Standard is at v1.6.0.
-
-Changes include:
-
-- New plugin APIs for block compressors, extensions, and schemas.
-
-- New global configuration mechanism (``asdf.get_config()``).
-
-- Support for the asdf:// URI scheme.
-
-- Drop support for Python 3.5.
-
-- Support for ASDF Standard 1.6.0, which is available via the
-  ``version`` argument to ``AsdfFile.__init__`` but not yet the
-  default.
-
-- Values that match defaults defined in schemas are no longer
-  automatically removed from the ASDF tree.
-
-- ``None`` values are no longer removed from the tree on write.
-
-- Remove the ``asdf.test`` method and ``asdf.__githash__`` attribute.
-
-- And more, see full changelog below for details.
-
-What's new in asdf 2.7.5?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-- Fix bug in ``asdf.schema.check_schema`` causing relative references in
-  metaschemas to be resolved incorrectly.
-
-- Fix bug that corrupts ndarray views when a new block is added
-  to an existing file in absence of a block index.
-
-What's New in asdf 2.7.4?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-- Fix pytest plugin failure under older versions of pytest.
-
-- Fix bugs when serializing views over non-contiguous and FITS
-  base arrays.
-
-- Add support for opening files from HTTPS URLs and following
-  HTTP/HTTPS redirects.
-
-What's New in asdf 2.7.3?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-- Fix bug resulting in invalid strides values for views over
-  FITS arrays.
-
-- Add pytest plugin options to skip and xfail individual tests
-  and xfail the unsupported ndarray-1.0.0 schema example.
-
-What's New in asdf 2.7.2?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-* Fix bug causing test collection failures under Python 3.9.
-
-* Fix bug when decompressing arrays with numpy 1.20.
-
-* Replace ``assert`` statements with ``raise`` at the behest
-  of the bandit security linter.
-
-What's New in asdf 2.7.1?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-The sole change in this release:
-
-* Fix bug preventing access to copied array data after
-  an ``AsdfFile`` is closed.
-
-What's New in asdf 2.7.0?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-* Performance improvements when reading and validating
-  ASDF files.
-
-* Numerous bug fixes.  See complete changelog below for details.
-
-* Add option to ``asdf.open`` that disables schema validation on read.
-
-* Improved warning messages.  All `asdf` library warnings now
-  subclass ``asdf.exceptions.AsdfWarning``.
-
-* Drop support for filling default values from subschemas
-  within oneOf or anyOf combiners.
-
-* Resolve deprecation warnings from the `asdf` pytest plugin
-  when used with newer versions of pytest.
-
-* Drop support for 2.x versions of the jsonschema package.
-
-What's New in asdf 2.6.0?
-=========================
-
-The ASDF Standard is at v1.5.0.
-
-Changes include:
-
-* ASDF Standard 1.5.0 is now the default for new files.  Changes to
-  the standard include several new and updated transform schemas,
-  and removal of wcs schemas that were previously deprecated and
-  moved to the ``gwcs`` package.
-
-* Add ``asdf.info`` and ``AsdfFile.search`` methods for visualizing
-  and interactively searching an ASDF tree.
-
-* Fix bug causing too many bytes to be consumed when reading
-  compressed blocks.
-
-* Support validation and serialization of additional numpy
-  scalar types.
-
-* Fix serialization of trees containing implicit internal references
-  and reference cycles, and simplify handling of children in
-  ``ExtensionType`` subclasses.
-
-* Fix bug preventing addition of history entires to a file that
-  was initially saved without them.
-
-* Expand developer documentation to cover the details of pyyaml
-  integration and conversion between tagged trees and custom trees.
-
-What's New in asdf 2.5.2?
-=========================
-
-The ASDF Standard is at v1.4.0.
-
-Changes include:
-
-* Add schemas that were previously missing from ASDF Standard 1.4.0,
-  and fix a variety of minor issues in ``AsdfType`` subclasses.
-
-* Add general and versioning-specific developer documentation.
-
-What's New in asdf 2.5.1?
-=========================
-
-The ASDF Standard is at v1.4.0.
-
-Changes include:
-
-* Fix bug in test causing failure when test suite is run against
-  an installed `asdf` package.
-
-What's New in asdf 2.5.0?
-=========================
-
-The ASDF Standard is at v1.4.0.
-
-Changes include:
-
-* Added convenience method for fetching the default resolver
-
-* Fixed load_schema LRU cache memory usage issue
-
-* Fixed bug causing segfault after update of a memory-mapped file.
-
-What's New in asdf 2.4.2?
-=========================
-
-The ASDF Standard is at v1.3.0. Changes include:
-
-* Define the ``in`` operator for top-level ``AsdfFile`` objects.
-
-* Automatically register schema tester plugin. Do not enable schema tests by
-  default. Add configuration setting and command line option to enable schema
-  tests.
-
-* Enable handling of subclasses of known custom types by using decorators for
-  convenience.
-
-* Add support for jsonschema 3.x.
-
-* Fix bug in ``NDArrayType.__len__``.  It must be a method, not a
-  property.
-
-What's New in asdf 2.3.3?
-=========================
-
-The ASDF Standard is at v1.3.0. Changes include:
-
-* Pass ``ignore_unrecognized_tag`` setting through to ASDF-in-FITS.
-
-* Use ``$schema`` keyword if available to determine meta-schema to use when
-  testing whether schemas themselves are valid.
-
-* Take into account resolvers from installed extensions when loading schemas
-  for validation.
-
-* Fix compatibility issue with new release of ``pyyaml`` (version 5.1).
-
-* Allow use of ``pathlib.Path`` objects for ``custom_schema`` option.
-
-What's New in asdf 2.3.1?
-=========================
-
-he ASDF Standard is at v1.3.0. Changes include:
-
-* Provide source information for ``AsdfDeprecationWarning`` that come from
-  extensions from external packages.
-
-* Fix the way ``generic_io`` handles URIs and paths on Windows.
-
-* Fix bug in ``asdftool`` that prevented ``extract`` command from being
-  visible.
-
-What's New in asdf 2.3?
-=======================
-
-`asdf` 2.3 reflects the update of ASDF Standard to v1.3.0, and contains a few
-notable features and an API change:
-
-* Storage of arbitrary precision integers is now provided by
-  `asdf.IntegerType`. This new type is provided by version 1.3.0 of the ASDF
-  Standard.
-
-* Reading a file with integer literals that are too large now causes only a
-  warning instead of a validation error. This is to provide backwards
-  compatibility for files that were created with a buggy version of `asdf`.
-
-* The functions `asdf.open` and `AsdfFile.write_to` now support the use of
-  `pathlib.Path`.
-
-* The `asdf.asdftypes` module has been deprecated in favor of `asdf.types`. The
-  old module will be removed entirely in the 3.0 release.
-
-What's New in asdf 2.2?
-=======================
-
-`asdf` 2.2 contains several API changes, although backwards compatibilty is
-preserved for now. The most significant changes are:
-
-* The function `AsdfFile.open` has been deprecated in favor of `asdf.open`.
-  It will be removed entirely in the 3.0 release. More intelligent file mode
-  handling has been added to `asdf.open`. Files that are opened in read-only
-  mode with `asdf.open` now explicitly block writes to memory-mapped arrays.
-  This may cause problems for some existing code, but any such code was
-  accessing these arrays in an unsafe manner, so backwards compatibility for
-  this case is not provided. The old mode handling behavior is retained for now
-  in `AsdfFile.open`.
-
-* It is now possible to disable lazy loading of internal arrays. This is useful
-  when the `AsdfFile` was opened using another open file. With lazy loading, it
-  is possible to close the original file but still retain access to the array
-  data.
-
-* There is a new warning `AsdfConversionWarning` that occurs when failing to
-  convert nodes in the ASDF tree into custom tagged types. This makes it easier
-  for users to filter specifically for this failure case.
-
-What's New in asdf 2.1?
-=======================
-
-`asdf` 2.1 is a minor release, and most of the changes affect only a subset of
-users. The most notable changes are the following:
-
-* `namedtuple` objects can now be serialized. They are automatically converted
-  into `list` objects, and therefore are not strictly able to round-trip. By
-  default a warning occurs when performing this conversion, but the warning can
-  be disabled by passing `ignore_implicit_conversion=True` to the `AsdfFile`
-  constructor.
-
-* Added a method `AsdfFile.get_history_entries` for getting a list of history
-  entries from the tree.
-
-* Added an option to `generic_io.get_file` to close the underlying file handle.
-
-Please see the :ref:`change_log` for additional details.
-
-What's New in asdf 2.0?
-=======================
-
-`asdf` 2.0 is a major release that includes many improvements, new features, and
-some API changes. It is the first release of the `asdf` package that only
-supports Python 3.
-
-The full list of changes, including bug fixes, can be found in the
-:ref:`change_log`. A brief overview of changes is provided below:
-
-* Support for Python 2.7 has been removed entirely.
-
-* There is no longer a hard dependency on `astropy`. It is still required for
-  some features, and for running the tests. Astropy-related tag implementations
-  have been moved to the Astropy package itself.
-* External packages can now install and register custom ASDF extensions using
-  `setuptools` entry points (see :ref:`other_packages` and
-  :ref:`packaging_extensions`). `asdf` detects extensions that are installed in
-  this way and automatically uses them when reading and writing files with
-  custom types.
-* A bug was fixed that now allows fully-specified tags from external packages
-  to be properly resolved.
-* The file format now includes metadata about the extensions that were used to
-  create an ASDF file. The software automatically adds this information when
-  writing an ASDF file, and will check for installed extensions when reading
-  a file containing such metadata (see :ref:`extension_checking`).
-* The restrictions on the top-level attributes `data`, `wcs`, and `fits` have
-  been removed.
-* Clients that wish to impose additional validation requirements on files can
-  now provide custom top-level schemas (see :ref:`custom-schemas`).
-* There is a new way to reference array data that is defined in external files
-  (see :ref:`array-references`).
-* Several new commands have been added to the `asdftool` command line
-  interface:
-
-  * ``extensions`` for showing information about installed extensions (see
-        :ref:`other_packages`).
-  * ``remove-hdu`` for removing ASDF extension from ASDF-in-FITS file
-      (requires `astropy`, see :ref:`asdf-in-fits`).
-
-* The package now cleanly supports builds in `develop` mode and can be imported
-  from the source tree.
-
-.. _change_log:
-
-Change Log
-==========
+***********
+Change  Log
+***********
 
 .. include:: ../../CHANGES.rst
diff --git a/docs/index.rst b/docs/index.rst
index d207827b5..ecfa50f8c 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -22,14 +22,13 @@ Getting Started
 ===============
 
 .. toctree::
-   :maxdepth: 2
+  :maxdepth: 2
 
-   asdf/install
-   asdf/overview
-   asdf/features
-   asdf/config
-   asdf/asdf_tool
-   asdf/changes
+  asdf/install
+  asdf/overview
+  asdf/features
+  asdf/config
+  asdf/asdf_tool
 
 .. _extending:
 
@@ -91,6 +90,13 @@ See also
 
 - `asdf` Python package distribution on `pypi <https://pypi.org/project/asdf/>`_
 
+Changes
+=======
+.. toctree::
+  :maxdepth: 2
+
+  asdf/changes
+
 Index
 =====
 

From 179b22d1c684f64bdbb4345c839054ceaee87ba6 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Thu, 2 Jun 2022 20:20:41 -0400
Subject: [PATCH 08/18] Fix hover

---
 docs/_static/custom.css | 34 ++++++++++++++++++++++++++++++++--
 docs/conf.py            |  4 ++++
 2 files changed, 36 insertions(+), 2 deletions(-)

diff --git a/docs/_static/custom.css b/docs/_static/custom.css
index 9463628be..dacff8e30 100644
--- a/docs/_static/custom.css
+++ b/docs/_static/custom.css
@@ -1,9 +1,39 @@
-div.highlight {
+div.admonition {
     transition: width 0.5s;
     -webkit-transition: width 0.5s;
     overflow: hidden;
 }
 
-div.highlight:hover {
+div.admonition:active {
+    width: 150%
+}
+
+div.highlight-yaml {
+    transition: width 0.5s;
+    -webkit-transition: width 0.5s;
+    overflow: hidden;
+}
+
+div.highlight-yaml:active {
+    width: 150%
+}
+
+div.highlight-default {
+    transition: width 0.5s;
+    -webkit-transition: width 0.5s;
+    overflow: hidden;
+}
+
+div.highlight-default:active {
+    width: 150%
+}
+
+div.highlight-python {
+    transition: width 0.5s;
+    -webkit-transition: width 0.5s;
+    overflow: hidden;
+}
+
+div.highlight-python:active {
     width: 150%
 }
diff --git a/docs/conf.py b/docs/conf.py
index 47afeb308..b432e99aa 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -141,3 +141,7 @@
 
 sys.path.insert(0, os.path.join(os.path.abspath(os.path.dirname("__file__")), "sphinxext"))
 extensions += ["example"]
+
+
+def setup(app):
+    app.add_css_file("custom.css")

From b37bdbd1154ddde885e3005807ae63026fdcdd17 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Thu, 2 Jun 2022 21:57:10 -0400
Subject: [PATCH 09/18] Enable intersphinx to asdf-standard

---
 docs/asdf/developer_versioning.rst |  6 ++----
 docs/asdf/extending/legacy.rst     |  4 ++--
 docs/asdf/extending/schemas.rst    | 13 +++++++++----
 docs/asdf/features.rst             | 13 +++++++------
 docs/conf.py                       |  2 ++
 docs/index.rst                     |  4 ++--
 6 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/docs/asdf/developer_versioning.rst b/docs/asdf/developer_versioning.rst
index c16407608..dca940d95 100644
--- a/docs/asdf/developer_versioning.rst
+++ b/docs/asdf/developer_versioning.rst
@@ -10,12 +10,10 @@ being trialled in the asdf-astropy package.
 ASDF versioning conventions
 ---------------------------
 
-The ASDF Standard document provides a helpful overview_ of the various ASDF
-versioning conventions.  We will be concerned with the *standard version*
+The ASDF Standard document provides a helpful :ref:`overview <asdf-standard:versioning-conventions>`
+of the various ASDF versioning conventions.  We will be concerned with the *standard version*
 and individual *tag versions*.
 
-.. _overview: https://asdf-standard.readthedocs.io/en/latest/versioning.html
-
 Overview
 --------
 
diff --git a/docs/asdf/extending/legacy.rst b/docs/asdf/extending/legacy.rst
index 319f9ff17..88b91092c 100644
--- a/docs/asdf/extending/legacy.rst
+++ b/docs/asdf/extending/legacy.rst
@@ -691,8 +691,8 @@ Creating custom schemas
 -----------------------
 
 All custom types to be serialized by `asdf` require custom schemas. The best
-resource for creating ASDF schemas can be found in the `ASDF Standard
-<https://asdf-standard.readthedocs.io/en/latest/schemas.html>`_ documentation.
+resource for creating ASDF schemas can be found in the :ref:`ASDF Standard
+<asdf-standard:asdf-schemas>` documentation.
 
 In most cases, ASDF schemas will be included as part of a packaged software
 distribution. In these cases, it is important for the
diff --git a/docs/asdf/extending/schemas.rst b/docs/asdf/extending/schemas.rst
index 6e0397138..2cb5898ac 100644
--- a/docs/asdf/extending/schemas.rst
+++ b/docs/asdf/extending/schemas.rst
@@ -49,7 +49,7 @@ numeric value and corresponding unit:
       required: [value, unit]
     ...
 
-This is similar to the `quantity schema`_ in the ASDF Standard, but
+This is similar to the quantity schema, found :ref:`here <asdf-standard:unit-schema>`, of the ASDF Standard, but
 has been updated to reflect current recommendations regarding schemas.
 Let's walk through this schema line by line.
 
@@ -241,6 +241,11 @@ function will validate a Python object against a schema:
 The validate function will return successfully if the object is valid, or raise
 an error if not.
 
-.. _JSON Schema Draft 4: https://json-schema.org/specification-links.html#draft-4
-.. _Understanding JSON Schema: https://json-schema.org/understanding-json-schema/
-.. _quantity schema: https://asdf-standard.readthedocs.io/en/latest/generated/stsci.edu/asdf/unit/quantity-1.1.0.html
+See also:
+=========
+
+- `JSON Schema Draft 4 <https://json-schema.org/specification-links.html#draft-4>`_
+
+- `Understanding JSON Schema <https://json-schema.org/understanding-json-schema/>`_
+
+- :ref:`Unit Schemas <asdf-standard:unit-schema>`
diff --git a/docs/asdf/features.rst b/docs/asdf/features.rst
index 7f8099930..ad4b3a6d6 100644
--- a/docs/asdf/features.rst
+++ b/docs/asdf/features.rst
@@ -23,9 +23,9 @@ and reading trees, see :ref:`overview`.
 .. note::
 
    The ASDF Standard imposes a maximum size of 64-bit signed integers literals in
-   the tree (see `the docs <https://asdf-standard.readthedocs.io/en/latest/known_limits.html#literal-integer-values-in-the-tree>`_
-   for details and justification). Attempting to store a larger value as a YAML literal will
-   result in a validation error.
+   the tree (see :ref:`<asdf-standard:literal_integers>` for details and justification).
+   Attempting to store a larger value as a YAML literal will result in a validation
+   error.
 
    For arbitrary precision integer support, see `IntegerType`.
 
@@ -92,8 +92,8 @@ Schema validation
 =================
 
 Schema validation is used to determine whether an ASDF file is well formed. All
-ASDF files must conform to the schemas defined by the `ASDF Standard
-<https://asdf-standard.readthedocs.io/en/latest/>`_. Schema validation occurs
+ASDF files must conform to the schemas defined by the :ref:`ASDF Standard
+<asdf-standard:asdf-standard>`. Schema validation occurs
 when reading ASDF files (using `asdf.open`), and also when writing them out
 (using `AsdfFile.write_to` or `AsdfFile.update`).
 
@@ -181,7 +181,8 @@ pass the schema URI (``http://example.com/schemas/your-custom-schema``, in this
 case) instead of a file path.
 
 .. _top-level core schema:
-    https://github.com/asdf-format/asdf-standard/blob/master/schemas/stsci.edu/asdf/core/asdf-1.1.0.yaml
+.. note::
+    The top-level core schemas can be found :ref:`here <asdf-standard:core-schema>`.
 
 .. _version_and_compat:
 
diff --git a/docs/conf.py b/docs/conf.py
index b432e99aa..f6d0df923 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -54,6 +54,8 @@
 # If your documentation needs a minimal Sphinx version, state it here.
 # needs_sphinx = '1.2'
 
+intersphinx_mapping["asdf-standard"] = ("https://asdf-standard.readthedocs.io/en/latest/", None)
+
 # To perform a Sphinx version check that needs to be more specific than
 # major.minor, call `check_sphinx_version("x.y.z")` here.
 # check_sphinx_version("1.2.1")
diff --git a/docs/index.rst b/docs/index.rst
index ecfa50f8c..092dbe4d4 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -85,8 +85,8 @@ improvements to the ASDF Standard can be reported `here
 See also
 ========
 
-- The `Advanced Scientific Data Format (ASDF) standard
-  <https://asdf-standard.readthedocs.io/>`__
+- The :ref:`Advanced Scientific Data Format (ASDF) standard
+  <asdf-standard:asdf-standard>`.
 
 - `asdf` Python package distribution on `pypi <https://pypi.org/project/asdf/>`_
 

From 62ccb874fa532b1b6dd4689d12455bc140668d76 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Fri, 3 Jun 2022 10:00:55 -0400
Subject: [PATCH 10/18] Add logo to sidebar

---
 docs/conf.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/conf.py b/docs/conf.py
index f6d0df923..92072caad 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -113,6 +113,7 @@
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
 html_favicon = "_static/logo.ico"
+html_logo = "_static/logo.png"
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.

From f43203dc592671d7e9192438ab31edce252e0e93 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Fri, 3 Jun 2022 10:35:59 -0400
Subject: [PATCH 11/18] Add more intersphinx links

---
 docs/asdf/developer_overview.rst | 2 +-
 docs/asdf/extending/legacy.rst   | 2 +-
 docs/conf.py                     | 2 ++
 3 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/asdf/developer_overview.rst b/docs/asdf/developer_overview.rst
index ec93ab2ff..fa9da682b 100644
--- a/docs/asdf/developer_overview.rst
+++ b/docs/asdf/developer_overview.rst
@@ -105,7 +105,7 @@ Or a resource mapping plugin added at runtime like this::
 **Entry point:** A Python packaging feature that allows asdf to use plugins
 provided by other packages.  Entry points are registered when a package is
 installed and become available to asdf without any additional effort on
-the part of the user.  See `<https://packaging.python.org/specifications/entry-points/>`_
+the part of the user.  See :ref:`pypa-packaging:entry-points`
 for more information.
 
 **Resource mapping:** An asdf plugin that provides access to "resources" which
diff --git a/docs/asdf/extending/legacy.rst b/docs/asdf/extending/legacy.rst
index 88b91092c..8f6779f68 100644
--- a/docs/asdf/extending/legacy.rst
+++ b/docs/asdf/extending/legacy.rst
@@ -871,7 +871,7 @@ Testing custom schemas
 ----------------------
 
 Packages that provide their own schemas can test them using `asdf`'s
-`pytest <https://docs.pytest.org/en/latest/>`_ plugin for schema testing.
+:ref:`pytest <pytest:toc>` plugin for schema testing.
 Schemas are tested for overall validity, and any examples given within the
 schemas are also tested.
 
diff --git a/docs/conf.py b/docs/conf.py
index 92072caad..cab93363f 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -54,7 +54,9 @@
 # If your documentation needs a minimal Sphinx version, state it here.
 # needs_sphinx = '1.2'
 
+intersphinx_mapping["pypa-packaging"] = ("https://packaging.python.org/en/latest/", None)
 intersphinx_mapping["asdf-standard"] = ("https://asdf-standard.readthedocs.io/en/latest/", None)
+intersphinx_mapping["pytest"] = ("https://docs.pytest.org/en/latest/", None)
 
 # To perform a Sphinx version check that needs to be more specific than
 # major.minor, call `check_sphinx_version("x.y.z")` here.

From 577a3cf77ed3d54068ad99ca9a1302b2e3338b54 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Fri, 3 Jun 2022 13:46:58 -0400
Subject: [PATCH 12/18] Add asdf-sphinx

---
 asdf/resource.py       | 2 +-
 docs/asdf/features.rst | 2 +-
 docs/conf.py           | 2 +-
 setup.cfg              | 1 +
 4 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/asdf/resource.py b/asdf/resource.py
index 0dc4dfbd5..2e0f97933 100644
--- a/asdf/resource.py
+++ b/asdf/resource.py
@@ -22,7 +22,7 @@ class DirectoryResourceMapping(_DirectoryResourceMapping):
     """
     A resource mapping that reads resource content from a directory or directory tree.
 
-    See :class:`~asdf_standard.resource.DirectoryResourceMapping` for details.
+    See :ref:`asdf_standard.resource.DirectoryResourceMapping` for details.
     """
 
     pass
diff --git a/docs/asdf/features.rst b/docs/asdf/features.rst
index ad4b3a6d6..5bf940b20 100644
--- a/docs/asdf/features.rst
+++ b/docs/asdf/features.rst
@@ -464,7 +464,7 @@ create an `AsdfInFits` object.
     from asdf import fits_embed
 
     ff = fits_embed.AsdfInFits(hdulist, tree)
-    ff.write_to('embedded_asdf.fits')
+    ff.write_to('embedded_asdf.fits', overwrite=True)
 
 .. runcode:: hidden
 
diff --git a/docs/conf.py b/docs/conf.py
index cab93363f..a30599fda 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -145,7 +145,7 @@
 man_pages = [("index", project.lower(), project + " Documentation", [author], 1)]
 
 sys.path.insert(0, os.path.join(os.path.abspath(os.path.dirname("__file__")), "sphinxext"))
-extensions += ["example"]
+extensions += ["example", "sphinx_asdf"]
 
 
 def setup(app):
diff --git a/setup.cfg b/setup.cfg
index d14a6c573..3560ee477 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -45,6 +45,7 @@ all =
     lz4>=0.10
 docs =
     sphinx
+    sphinx-asdf
     sphinx-astropy
     astropy>=5.0.4
     graphviz

From 9fabbff82a963b2b65677f057c07d1e82e5264ad Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Fri, 3 Jun 2022 16:58:20 -0400
Subject: [PATCH 13/18] Fix note click

---
 asdf/resource.py        | 2 +-
 docs/_static/custom.css | 4 ++++
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/asdf/resource.py b/asdf/resource.py
index 2e0f97933..0dc4dfbd5 100644
--- a/asdf/resource.py
+++ b/asdf/resource.py
@@ -22,7 +22,7 @@ class DirectoryResourceMapping(_DirectoryResourceMapping):
     """
     A resource mapping that reads resource content from a directory or directory tree.
 
-    See :ref:`asdf_standard.resource.DirectoryResourceMapping` for details.
+    See :class:`~asdf_standard.resource.DirectoryResourceMapping` for details.
     """
 
     pass
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
index dacff8e30..3b01e4b50 100644
--- a/docs/_static/custom.css
+++ b/docs/_static/custom.css
@@ -8,6 +8,10 @@ div.admonition:active {
     width: 150%
 }
 
+div.note:active {
+    width: 100%
+}
+
 div.highlight-yaml {
     transition: width 0.5s;
     -webkit-transition: width 0.5s;

From 849c2fe42b806d2fa818f8044e24fc6390c669f8 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Mon, 6 Jun 2022 15:20:49 -0400
Subject: [PATCH 14/18] Fix intersphinx link

---
 docs/asdf/features.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/asdf/features.rst b/docs/asdf/features.rst
index 5bf940b20..3ee808a3b 100644
--- a/docs/asdf/features.rst
+++ b/docs/asdf/features.rst
@@ -23,7 +23,7 @@ and reading trees, see :ref:`overview`.
 .. note::
 
    The ASDF Standard imposes a maximum size of 64-bit signed integers literals in
-   the tree (see :ref:`<asdf-standard:literal_integers>` for details and justification).
+   the tree (see :ref:`asdf-standard:literal_integers` for details and justification).
    Attempting to store a larger value as a YAML literal will result in a validation
    error.
 

From c44a336b73b7505a2fedbd572e0f63c480fe5b9f Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Mon, 6 Jun 2022 15:32:58 -0400
Subject: [PATCH 15/18] Update readme to better display asdf file

---
 README.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.rst b/README.rst
index bf49c9689..8b2ff0ccd 100644
--- a/README.rst
+++ b/README.rst
@@ -101,10 +101,10 @@ input to the constructor of `AsdfFile`:
     # Write the data to a new file
     af.write_to('example.asdf')
 
-If we open the newly created file, we can see some of the key features
+If we open the newly created file's metadata section, we can see some of the key features
 of ASDF on display:
 
-::
+.. code:: yaml
 
     #ASDF 1.0.0
     #ASDF_STANDARD 1.2.0

From 571c2d503c45c933abb975232d3bea04ccd5fb07 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Mon, 6 Jun 2022 16:15:23 -0400
Subject: [PATCH 16/18] Better rendering of asdf file from readme

---
 README.rst                | 11 ++++-
 docs/asdf/overview.rst    | 41 ++++++++++++++++
 docs/sphinxext/example.py | 99 ++++++++++++++++++++-------------------
 3 files changed, 102 insertions(+), 49 deletions(-)

diff --git a/README.rst b/README.rst
index 8b2ff0ccd..000e57fc4 100644
--- a/README.rst
+++ b/README.rst
@@ -104,6 +104,8 @@ input to the constructor of `AsdfFile`:
 If we open the newly created file's metadata section, we can see some of the key features
 of ASDF on display:
 
+.. _begin-example-asdf-metadata:
+
 .. code:: yaml
 
     #ASDF 1.0.0
@@ -138,11 +140,16 @@ of ASDF on display:
       shape: [100]
     ...
 
+.. _end-example-asdf-metadata:
+
 The metadata in the file mirrors the structure of the tree that was stored. It
 is hierarchical and human-readable. Notice that metadata has been added to the
 tree that was not explicitly given by the user. Notice also that the numerical
 array data is not stored in the metadata tree itself. Instead, it is stored as
-binary data blocks below the metadata section (not shown here).
+binary data blocks below the metadata section (not shown above).
+
+.. _end-create-file-text:
+.. _begin-compress-file:
 
 It is possible to compress the array data when writing the file:
 
@@ -154,7 +161,7 @@ The built-in compression algorithms are ``'zlib'``, and ``'bzp2'``.  The
 ``'lz4'`` algorithm becomes available when the `lz4 <https://python-lz4.readthedocs.io/>`__ package
 is installed.  Other compression algorithms may be available via extensions.
 
-.. _end-create-file-text:
+.. _end-compress-file:
 
 Reading a file
 ~~~~~~~~~~~~~~
diff --git a/docs/asdf/overview.rst b/docs/asdf/overview.rst
index 24d8040c6..3a5d6fa4a 100644
--- a/docs/asdf/overview.rst
+++ b/docs/asdf/overview.rst
@@ -38,10 +38,51 @@ save a :class:`dict` with the key/value pair ``'hello': 'world'``.
 Creating Files
 ==============
 
+.. runcode:: hidden
+
+    import asdf
+    import numpy as np
+
+    # Create some data
+    sequence = np.arange(100)
+    squares  = sequence**2
+    random = np.random.random(100)
+
+    # Store the data in an arbitrarily nested dictionary
+    tree = {
+        'foo': 42,
+        'name': 'Monty',
+        'sequence': sequence,
+        'powers': { 'squares' : squares },
+        'random': random
+    }
+
+    # Create the ASDF file object from our data tree
+    af = asdf.AsdfFile(tree)
+
+    # Write the data to a new file
+    af.write_to('example.asdf')
+
 .. include:: ../../README.rst
     :start-after: begin-create-file-text:
+    :end-before: begin-example-asdf-metadata:
+
+.. asdf:: example.asdf no_blocks
+
+.. include:: ../../README.rst
+    :start-after: end-example-asdf-metadata:
     :end-before: end-create-file-text:
 
+A rendering of the binary data contained in the file can be found below. Observe that
+the value of ``source`` in the metadata corresponds to the block number (e.g. ``BLOCK 0``)
+of the block which contains the binary data.
+
+.. asdf:: example.asdf no_header
+
+.. include:: ../../README.rst
+    :start-after: _begin-compress-file:
+    :end-before: _end-compress-file:
+
 Reading Files
 =============
 
diff --git a/docs/sphinxext/example.py b/docs/sphinxext/example.py
index 68639993d..3f2bf53cb 100644
--- a/docs/sphinxext/example.py
+++ b/docs/sphinxext/example.py
@@ -68,6 +68,9 @@ def run(self):
         cwd = os.getcwd()
         os.chdir(TMPDIR)
 
+        show_header = not ("no_header" in self.arguments)
+        show_bocks = not ("no_blocks" in self.arguments)
+
         parts = []
         try:
             ff = AsdfFile()
@@ -79,59 +82,61 @@ def run(self):
             literal = nodes.literal_block(code, code)
             literal["language"] = "yaml"
             set_source_info(self, literal)
-            parts.append(literal)
+            if show_header:
+                parts.append(literal)
 
             kwargs = dict()
             # Use the ignore_unrecognized_tag parameter as a proxy for both options
             kwargs["ignore_unrecognized_tag"] = "ignore_unrecognized_tag" in self.arguments
             kwargs["ignore_missing_extensions"] = "ignore_unrecognized_tag" in self.arguments
 
-            with asdf.open(filename, **kwargs) as ff:
-                for i, block in enumerate(ff.blocks.internal_blocks):
-                    data = codecs.encode(block.data.tobytes(), "hex")
-                    if len(data) > 40:
-                        data = data[:40] + "...".encode()
-                    allocated = block._allocated
-                    size = block._size
-                    data_size = block._data_size
-                    flags = block._flags
-
-                    if flags & BLOCK_FLAG_STREAMED:
-                        allocated = size = data_size = 0
-
-                    lines = []
-                    lines.append("BLOCK {0}:".format(i))
-
-                    human_flags = []
-                    for key, val in FLAGS.items():
-                        if flags & key:
-                            human_flags.append(val)
-                    if len(human_flags):
-                        lines.append("    flags: {0}".format(" | ".join(human_flags)))
-                    if block.input_compression:
-                        lines.append("    compression: {0}".format(block.input_compression))
-                    lines.append("    allocated_size: {0}".format(allocated))
-                    lines.append("    used_size: {0}".format(size))
-                    lines.append("    data_size: {0}".format(data_size))
-                    lines.append("    data: {0}".format(data))
-
-                    code = "\n".join(lines)
-                    code += "\n"
-
-                    literal = nodes.literal_block(code, code)
-                    literal["language"] = "yaml"
-                    set_source_info(self, literal)
-                    parts.append(literal)
-
-                internal_blocks = list(ff.blocks.internal_blocks)
-                if len(internal_blocks) and internal_blocks[-1].array_storage != "streamed":
-                    buff = io.BytesIO()
-                    ff.blocks.write_block_index(buff, ff)
-                    block_index = buff.getvalue().decode("utf-8")
-                    literal = nodes.literal_block(block_index, block_index)
-                    literal["language"] = "yaml"
-                    set_source_info(self, literal)
-                    parts.append(literal)
+            if show_bocks:
+                with asdf.open(filename, **kwargs) as ff:
+                    for i, block in enumerate(ff.blocks.internal_blocks):
+                        data = codecs.encode(block.data.tobytes(), "hex")
+                        if len(data) > 40:
+                            data = data[:40] + "...".encode()
+                        allocated = block._allocated
+                        size = block._size
+                        data_size = block._data_size
+                        flags = block._flags
+
+                        if flags & BLOCK_FLAG_STREAMED:
+                            allocated = size = data_size = 0
+
+                        lines = []
+                        lines.append("BLOCK {0}:".format(i))
+
+                        human_flags = []
+                        for key, val in FLAGS.items():
+                            if flags & key:
+                                human_flags.append(val)
+                        if len(human_flags):
+                            lines.append("    flags: {0}".format(" | ".join(human_flags)))
+                        if block.input_compression:
+                            lines.append("    compression: {0}".format(block.input_compression))
+                        lines.append("    allocated_size: {0}".format(allocated))
+                        lines.append("    used_size: {0}".format(size))
+                        lines.append("    data_size: {0}".format(data_size))
+                        lines.append("    data: {0}".format(data))
+
+                        code = "\n".join(lines)
+                        code += "\n"
+
+                        literal = nodes.literal_block(code, code)
+                        literal["language"] = "yaml"
+                        set_source_info(self, literal)
+                        parts.append(literal)
+
+                    internal_blocks = list(ff.blocks.internal_blocks)
+                    if len(internal_blocks) and internal_blocks[-1].array_storage != "streamed":
+                        buff = io.BytesIO()
+                        ff.blocks.write_block_index(buff, ff)
+                        block_index = buff.getvalue().decode("utf-8")
+                        literal = nodes.literal_block(block_index, block_index)
+                        literal["language"] = "yaml"
+                        set_source_info(self, literal)
+                        parts.append(literal)
 
         finally:
             os.chdir(cwd)

From 11313980dbf9423163a8fdb3aa94b1b67ef3b585 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Mon, 6 Jun 2022 16:17:22 -0400
Subject: [PATCH 17/18] Update changes

---
 CHANGES.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index ea9e5ca8e..181a01913 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,3 +1,10 @@
+2.12.1 (unreleased)
+-------------------
+
+The ASDF Standard is at v1.6.0
+
+- Overhaul of the ASDF documentation to make it more consistent and readable. [#1142]
+
 2.12.0 (2022-06-06)
 -------------------
 

From 2dbe52e86e2dd424cfc31214b3488ed11b9ea9d8 Mon Sep 17 00:00:00 2001
From: William Jamieson <wjamieson@stsci.edu>
Date: Mon, 6 Jun 2022 16:31:33 -0400
Subject: [PATCH 18/18] Add zenodo citation badge

---
 README.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/README.rst b/README.rst
index 000e57fc4..f855841ad 100644
--- a/README.rst
+++ b/README.rst
@@ -19,6 +19,9 @@ ASDF - Advanced Scientific Data Format
 .. image:: https://codecov.io/gh/asdf-format/asdf/branch/master/graphs/badge.svg
     :target: https://codecov.io/gh/asdf-format/asdf
 
+.. image:: https://zenodo.org/badge/18112754.svg
+    :target: https://zenodo.org/badge/latestdoi/18112754
+
 .. image:: https://img.shields.io/pypi/l/asdf.svg
     :target: https://img.shields.io/pypi/l/asdf.svg