diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index c55b771ba..5ac1c54a8 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -7,10 +7,10 @@ version: 2
 formats:
   # Temporarily disabling PDF downloads due to problem with nbsphinx in LateX builds
   # - pdf
-  - epub
+  - htmlzip
 
 python:
-  version: "3.7"
+  version: "3.8"
   install:
     - requirements: requirements-docs.txt
     - method: pip
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 17dcf2970..681684073 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,6 +12,34 @@
 
 ### Deprecated
 
+## [v1.3.0]
+
+### Added
+
+- Type annotations for instance attributes on all classes ([#705](https://github.com/stac-utils/pystac/pull/705))
+- `extensions.datacube.Variable.to_dict` method ([#699](https://github.com/stac-utils/pystac/pull/699)])
+- Clarification of possible errors when using `.ext` to extend an object ([#701](https://github.com/stac-utils/pystac/pull/701))
+- Downloadable documentation as zipped HTML ([#715](https://github.com/stac-utils/pystac/pull/715))
+
+### Removed
+
+- Downloadable documentation in ePub format ([#715](https://github.com/stac-utils/pystac/pull/715))
+
+### Changed
+
+- Reorganize docs and switch to PyData theme ([#687](https://github.com/stac-utils/pystac/pull/687))
+
+### Fixed
+
+- Quickstart tutorial is now up-to-date with all package changes ([#674](https://github.com/stac-utils/pystac/pull/674))
+- Creating absolute URLs from absolute URLs ([#697](https://github.com/stac-utils/pystac/pull/697)])
+- Serialization error when using `pystac.extensions.file.MappingObject` ([#700](https://github.com/stac-utils/pystac/pull/700))
+- Use `PropertiesExtension._get_property` to properly set return type in `TableExtension` ([#712](https://github.com/stac-utils/pystac/pull/712))
+- `DatacubeExtension.variables` now has a setter ([#699](https://github.com/stac-utils/pystac/pull/699)])
+- Landsat STAC tutorial is now up-to-date with all package changes ([#692](https://github.com/stac-utils/pystac/pull/674))
+- Paths to sub-catalog files when using `Catalog.save` ([#714](https://github.com/stac-utils/pystac/pull/714))
+- Link to PySTAC Introduction tutorial in tutorials index page ([#719](https://github.com/stac-utils/pystac/pull/719))
+
 ## [v1.2.0]
 
 ### Added
@@ -525,7 +553,8 @@ use `Band.create`
 
 Initial release.
 
-[Unreleased]: <https://github.com/stac-utils/pystac/compare/v1.2.0..main>
+[Unreleased]: <https://github.com/stac-utils/pystac/compare/v1.3.0..main>
+[v1.3.0]: <https://github.com/stac-utils/pystac/compare/v1.2.0..v1.3.0>
 [v1.2.0]: <https://github.com/stac-utils/pystac/compare/v1.1.0..v1.2.0>
 [v1.1.0]: <https://github.com/stac-utils/pystac/compare/v1.0.1..v1.1.0>
 [v1.0.1]: <https://github.com/stac-utils/pystac/compare/v1.0.0..v1.0.1>
diff --git a/docs/_static/STAC-03.png b/docs/_static/STAC-03.png
new file mode 100644
index 000000000..48783f210
Binary files /dev/null and b/docs/_static/STAC-03.png differ
diff --git a/docs/_static/custom.css b/docs/_static/custom.css
new file mode 100644
index 000000000..9235484fc
--- /dev/null
+++ b/docs/_static/custom.css
@@ -0,0 +1,21 @@
+.no-sidebar {
+    display: none;
+}
+
+.card-text a {
+    font-weight: 600;
+    color: rgb(255, 26, 26);
+}
+
+.card-header p {
+    font-size: large;
+    font-weight: 600;
+}
+
+.navbar-brand img {
+    height: 50px;
+}
+
+.navbar-brand {
+    height: 75px;
+}
diff --git a/docs/_templates/layout.html b/docs/_templates/layout.html
new file mode 100644
index 000000000..f36dc0cdc
--- /dev/null
+++ b/docs/_templates/layout.html
@@ -0,0 +1,20 @@
+{% extends "pydata_sphinx_theme/layout.html" %}
+
+{% block docs_main %}
+{% if sidebars %}
+  {% set content_col_class = "col-md-9 col-xl-7" %}
+{% else %}
+  {# This customization to the no-sidebars case is why we override docs_main #}
+  {% set content_col_class = "col-md-12" %}
+{% endif %}
+<main class="col-12 {{ content_col_class }} py-md-5 pl-md-5 pr-md-4 bd-content" role="main">
+    {% block docs_body %}
+    <div>
+      {% block body %} {% endblock %}
+    </div>
+    {% endblock %}
+    {% if theme_show_prev_next %}
+    {% include "prev-next.html" %}
+    {% endif %}
+</main>
+{% endblock %}
diff --git a/docs/api.rst b/docs/api.rst
index fb982fa69..5e53930dc 100644
--- a/docs/api.rst
+++ b/docs/api.rst
@@ -1,1044 +1,216 @@
 API Reference
 =============
 
-This API reference is auto-generated for the Python docstrings,
-and organized by the section of the :stac-spec:`STAC Spec <>` they relate to, if related
-to a specific spec item.
+.. toctree::
+   :hidden:
+   :maxdepth: 2
+   :glob:
 
-pystac
-------
-
-.. automodule:: pystac
-   :members: read_file, write_file, read_dict, set_stac_version, get_stac_version
-
-STACObject
-----------
-
-STACObject is the base class for :class:`Catalog <pystac.Catalog>`, :class:`Collection
-<pystac.Collection>` and :class:`Item <pystac.Item>`, and contains a variety of useful
-methods for dealing with links, copying objects, accessing extensions, and reading and
-writing files. You shouldn't use STACObject directly, but instead access this
-functionality through the implementing classes.
-
-.. autoclass:: pystac.STACObject
-   :members:
-   :inherited-members:
-   :undoc-members:
-
-.. autoclass:: pystac.STACObjectType
-   :members:
-   :undoc-members:
-
-
-Catalog Spec
-------------
-
-These classes are representations of the :stac-spec:`Catalog Spec <catalog-spec>`.
-
-Catalog
-~~~~~~~
-
-.. autoclass:: pystac.Catalog
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-CatalogType
-~~~~~~~~~~~
-
-.. autoclass:: pystac.CatalogType
-   :members:
-   :inherited-members:
-   :undoc-members:
-
-
-Collection Spec
----------------
-
-These classes are representations of the :stac-spec:`Collection Spec <collection-spec>`.
-
-Collection
-~~~~~~~~~~
-
-.. autoclass:: pystac.Collection
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Extent
-~~~~~~
-
-.. autoclass:: pystac.Extent
-   :members:
-   :undoc-members:
-
-SpatialExtent
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.SpatialExtent
-   :members:
-   :undoc-members:
-
-TemporalExtent
-~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.TemporalExtent
-   :members:
-   :undoc-members:
-
-ProviderRole
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.ProviderRole
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Provider
-~~~~~~~~
-
-.. autoclass:: pystac.Provider
-   :members:
-   :undoc-members:
-
-Summaries
-~~~~~~~~~
-
-.. autoclass:: pystac.Summaries
-   :members:
-   :undoc-members:
-
-Item Spec
----------
-
-These classes are representations of the :stac-spec:`Item Spec <item-spec>`.
-
-Item
-~~~~
-
-.. autoclass:: pystac.Item
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Asset
-~~~~~
-
-.. autoclass:: pystac.Asset
-   :members:
-   :undoc-members:
+   api/pystac
+   api/*
 
-CommonMetadata
-~~~~~~~~~~~~~~
+This API reference is auto-generated from the Python docstrings. The table of contents
+on the left is organized by module. The sections below are organized based on concepts
+and sections within the :stac-spec:`STAC Spec <>` and PySTAC itself.
 
-.. autoclass:: pystac.CommonMetadata
-   :members:
-   :undoc-members:
+Base Structures & Classes
+-------------------------
 
-ItemCollection
---------------
-Represents a GeoJSON FeatureCollection in which all Features are STAC Items
+These are the core Python classes representing entities within the STAC Spec. These
+classes provide convenient methods for serializing and deserializing from JSON,
+extracting properties, and creating relationships between entities.
 
-.. autoclass:: pystac.ItemCollection
-   :members:
-   :show-inheritance:
+* :class:`pystac.Link`: Represents a :stac-spec:`Link Object
+  <item-spec/item-spec.md#link-object>`.
+* :class:`pystac.MediaType`: Provides common values used in the Link and Asset
+  ``"type"`` fields.
+* :class:`pystac.RelType`: Provides common values used in the Link ``"rel"`` field.
+* :class:`pystac.STACObject`: Base class implementing functionality common to
+  :class:`Catalog <pystac.Catalog>`, :class:`Collection <pystac.Collection>` and
+  :class:`Item <pystac.Item>`.
 
-Links
+Items
 -----
 
-Catalogs, Collections and Items have links, which allow users to crawl catalogs.
-
-Link
-~~~~
+Representations of :stac-spec:`Items <item-spec/item-spec.md>` and related structures
+like :stac-spec:`Asset Objects<item-spec/item-spec.md#asset-object>`.
 
-.. autoclass:: pystac.Link
-   :members:
-   :undoc-members:
+* :class:`pystac.Asset`: Represents an :stac-spec:`Asset Object
+  <item-spec/item-spec.md#asset-object>`
+* :class:`pystac.Item`: Represents an :stac-spec:`Item <item-spec/item-spec.md>`
+* :class:`pystac.CommonMetadata`: A container for fields defined in the
+  :stac-spec:`Common Metadata <item-spec/common-metadata.md>` section of the spec.
+  These fields are commonly found in STAC Item properties, but may be found elsewhere.
 
-MediaType
-~~~~~~~~~
+Collections
+-----------
 
-.. autoclass:: pystac.MediaType
-   :members:
-   :undoc-members:
+These are representations of :stac-spec:`Collections
+<collection-spec/collectino-spec.md>` and related structures.
 
-RelType
-~~~~~~~
+* :class:`pystac.Collection`: Represents a :stac-spec:`Collection
+  <collection-spec/collection-spec.md>`.
+* :class:`pystac.Extent`: Represents an
+  :stac-spec:`Extent Object <collection-spec/collection-spec.md#extent-object>`, which
+  is composed of :class:`pystac.SpatialExtent` and :class:`pystac.TemporalExtent`
+  instances.
+* :class:`pystac.Provider`: Represents a :stac-spec:`Provider Object
+  <collection-spec/collection-spec.md#provider-object>`. The
+  :class:`pystac.ProviderRole` enum provides common values used in the ``"roles"``
+  field.
+* :class:`pystac.Summaries`: Class for working with various types of
+  :stac-spec:`CollectionSummaries <collection-spec/collection-spec.md#summaries>`
+* :class:`pystac.ItemCollection`: Represents a GeoJSON FeatureCollection in which all
+  Features are STAC Items.
 
-.. autoclass:: pystac.RelType
-   :members:
-   :undoc-members:
+Catalogs
+--------
 
-IO
---
+Representations of :stac-spec:`Catalogs <catalog-spec/catalog-spec.md>` and related
+structures.
 
-StacIO
-~~~~~~
+* :class:`pystac.Catalog`: Represents a :stac-spec:`Catalog
+  <catalog-spec/catalog-spec.md>`.
+* :class:`pystac.CatalogType`: Enum representing the common types of Catalogs described
+  in the :stac-spec:`STAC Best Practices
+  <https://github.com/radiantearth/stac-spec/blob/master/best-practices.md#use-of-links>`
 
-.. autoclass:: pystac.StacIO
-   :members:
-   :undoc-members:
 
-DefaultStacIO
-~~~~~~~~~~~~~
+I/O
+---
 
-.. autoclass:: pystac.stac_io.DefaultStacIO
-   :members:
-   :show-inheritance:
+These classes are used to read and write files from disk or over the network, as well
+as to serialize and deserialize STAC object to and from JSON.
 
-DuplicateKeyReportingMixin
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+* :class:`pystac.StacIO`: Base class that can be inherited to provide custom I/O
+* :class:`pystac.stac_io.DefaultStacIO`: The default :class:`pystac.StacIO`
+  implementation used throughout the library.
 
-.. autoclass:: pystac.stac_io.DuplicateKeyReportingMixin
-   :members:
-   :show-inheritance:
+Extensions
+----------
 
-Layout
-------
+PySTAC provides support for the following STAC Extensions:
+
+* :mod:`Datacube <pystac.extensions.datacube>`
+* :mod:`Electro-Optical <pystac.extensions.eo>`
+* :mod:`File Info <pystac.extensions.file>`
+* :mod:`Item Assets <pystac.extensions.item_assets>`
+* :mod:`Label <pystac.extensions.label>`
+* :mod:`Point Cloud <pystac.extensions.pointcloud>`
+* :mod:`Projection <pystac.extensions.projection>`
+* :mod:`Raster <pystac.extensions.raster>`
+* :mod:`SAR <pystac.extensions.sar>`
+* :mod:`Satellite <pystac.extensions.sat>`
+* :mod:`Scientific Citation <pystac.extensions.scientific>`
+* :mod:`Table <pystac.extensions.table>`
+* :mod:`Timestamps <pystac.extensions.timestamps>`
+* :mod:`Versioning Indicators <pystac.extensions.version>`
+* :mod:`View Geometry <pystac.extensions.view>`
+
+The following classes are used internally to implement these extensions and may be used
+to create custom implementations of STAC Extensions not supported by the library (see
+:tutorial:`Adding New and Custom Extensions <adding-new-and-custom-extensions.ipynb>`
+for details):
+
+* :class:`pystac.extensions.base.SummariesExtension`: Base class for extending the
+  properties in :attr:`pystac.Collection.summaries` to include properties defined by a
+  STAC Extension.
+* :class:`pystac.extensions.base.PropertiesExtension`: Abstract base class for
+  extending the properties of an :class:`~pystac.Item` to include properties defined
+  by a STAC Extension.
+* :class:`pystac.extensions.base.ExtensionManagementMixin`: Abstract base class with
+  methods for adding and removing extensions from STAC Objects.
+* :class:`pystac.extensions.hooks.ExtensionHooks`: Used to implement hooks when
+  extending a STAC Object. Primarily used to implement migrations from one extension
+  version to another.
+* :class:`pystac.extensions.hooks.RegisteredExtensionHooks`: Used to register hooks
+  defined in :class:`~pystac.extensions.hooks.ExtensionHooks` instances to ensure they
+  are used in object deserialization.
+
+
+Catalog Layout
+--------------
 
 These classes are used to set the HREFs of a STAC according to some layout.
 The templating functionality is also used when generating subcatalogs based on
 a template.
 
-Templating
-~~~~~~~~~~
-
-.. autoclass:: pystac.layout.LayoutTemplate
-   :members:
-
-.. autoclass:: pystac.layout.TemplateError
-
-HREF Layout Strategies
-~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.layout.BestPracticesLayoutStrategy
-
-.. autoclass:: pystac.layout.TemplateLayoutStrategy
-
-.. autoclass:: pystac.layout.CustomLayoutStrategy
+* :class:`pystac.layout.LayoutTemplate`: Represents a template that can be used for
+  deriving paths or other information based on properties of STAC objects supplied as a
+  template string.
+* :class:`pystac.layout.BestPracticesLayoutStrategy`: Layout strategy that represents
+  the catalog layout described in the :stac-spec:`STAC Best Practices documentation
+  <best-practices.md>`.
+* :class:`pystac.layout.TemplateLayoutStrategy`: Layout strategy that can take strings
+  to be supplied to a :class:`~pystac.layout.LayoutTemplate` to derive paths.
+* :class:`pystac.layout.CustomLayoutStrategy`: Layout strategy that allows users to
+  supply functions to dictate stac object paths.
 
 Errors
 ------
 
-STACError
-~~~~~~~~~
-
-.. autoclass:: pystac.STACError
-
-STACTypeError
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.STACTypeError
-
-DuplicateObjectKeyError
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.DuplicateObjectKeyError
-
-ExtensionAlreadyExistsError
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.ExtensionAlreadyExistsError
-
-ExtensionTypeError
-~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.ExtensionTypeError
-
-ExtensionNotImplemented
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.ExtensionNotImplemented
-
-ExtensionTypeError
-~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.ExtensionTypeError
-
-RequiredPropertyMissing
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.RequiredPropertyMissing
-
-STACValidationError
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.STACValidationError
-
-
-Extensions
-----------
-
-Base Classes
-------------
-
-Abstract base classes that should be inherited to implement specific extensions.
-
-SummariesExtension
-~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.base.SummariesExtension
-   :members:
-
-PropertiesExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.base.PropertiesExtension
-   :members:
-   :show-inheritance:
-
-ExtensionManagementMixin
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.base.ExtensionManagementMixin
-   :members:
-   :show-inheritance:
-
-Datacube Extension
-------------------
-
-These classes are representations of the :stac-ext:`EO Extension Spec <eo>`.
-
-DimensionType
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.DimensionType
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-HorizontalSpatialDimensionAxis
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.HorizontalSpatialDimensionAxis
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-VerticalSpatialDimensionAxis
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.VerticalSpatialDimensionAxis
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Dimension
-~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.Dimension
-   :members:
-   :show-inheritance:
-
-HorizontalSpatialDimension
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.HorizontalSpatialDimension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-VerticalSpatialDimension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.VerticalSpatialDimension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-TemporalDimension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.TemporalDimension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-AdditionalDimension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.AdditionalDimension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-VariableType
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.VariableType
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-Variable
-~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.Variable
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-DatacubeExtension
-~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.DatacubeExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-CollectionDatacubeExtension
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.CollectionDatacubeExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-ItemDatacubeExtension
-~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.ItemDatacubeExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-AssetDatacubeExtension
-~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.datacube.AssetDatacubeExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-Electro-Optical Extension
--------------------------
-
-These classes are representations of the :stac-ext:`EO Extension Spec <eo>`.
-
-Band
-~~~~
-
-.. autoclass:: pystac.extensions.eo.Band
-   :members:
-   :undoc-members:
-
-EOExtension
-~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.eo.EOExtension
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-ItemEOExtension
-~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.eo.ItemEOExtension
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-AssetEOExtension
-~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.eo.AssetEOExtension
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-SummariesEOExtension
-~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.eo.SummariesEOExtension
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-File Info Extension
--------------------
-
-These classes are representations of the :stac-ext:`File Info Extension Spec <file>`.
-
-ByteOrder
-~~~~~~~~~
-
-.. autoclass:: pystac.extensions.file.ByteOrder
-   :members:
-   :show-inheritance:
-   :undoc-members:
-
-MappingObject
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.file.MappingObject
-   :members:
-
-FileExtension
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.file.FileExtension
-   :members:
-   :show-inheritance:
-   :undoc-members:
-
-Item Assets Extension
----------------------
-
-These classes are representations of the :stac-ext:`Item Assets Extension Spec
-<item-assets>`.
-
-AssetDefinition
-~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.item_assets.AssetDefinition
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-ItemAssetsExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.item_assets.ItemAssetsExtension
-   :members:
-   :show-inheritance:
-
-Label Extension
----------------
-
-These classes are representations of the :stac-ext:`Label Extension Spec <label>`.
-
-LabelRelType
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelRelType
-   :members:
-   :show-inheritance:
-
-LabelType
-~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelType
-   :members:
-   :undoc-members:
-
-LabelClasses
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelClasses
-   :members:
-   :undoc-members:
-
-LabelOverview
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelOverview
-   :members:
-   :undoc-members:
-
-LabelCount
-~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelCount
-   :members:
-   :undoc-members:
-
-LabelStatistics
-~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelStatistics
-   :members:
-   :undoc-members:
-
-LabelExtension
-~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.label.LabelExtension
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Pointcloud Extension
---------------------
-
-These classes are representations of the :stac-ext:`Pointcloud Extension Spec
-<pointcloud>`.
-
-PhenomenologyType
-~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.PhenomenologyType
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-SchemaType
-~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.SchemaType
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Schema
-~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.Schema
-   :members:
-   :inherited-members:
-   :show-inheritance:
-
-Statistic
-~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.Statistic
-   :members:
-   :inherited-members:
-   :show-inheritance:
-
-PointcloudExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.PointcloudExtension
-   :members:
-   :inherited-members:
-   :show-inheritance:
-
-ItemPointcloudExtension
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.ItemPointcloudExtension
-   :members:
-   :show-inheritance:
-
-AssetPointcloudExtension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.pointcloud.AssetPointcloudExtension
-   :members:
-   :show-inheritance:
-
-Projection Extension
---------------------
-
-These classes are representations of the :stac-ext:`Projection Extension Spec
-<projection>`.
-
-ProjectionExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.projection.ProjectionExtension
-   :members:
-   :show-inheritance:
-
-ItemProjectionExtension
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.projection.ItemProjectionExtension
-   :members:
-   :show-inheritance:
-
-AssetProjectionExtension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.projection.AssetProjectionExtension
-   :members:
-   :show-inheritance:
-
-Raster Extension
-----------------
-
-DataType
-~~~~~~~~
-
-.. autoclass:: pystac.extensions.raster.DataType
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Statistics
-~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.raster.Statistics
-   :members:
-
-Histogram
-~~~~~~~~~
-
-.. autoclass:: pystac.extensions.raster.Histogram
-   :members:
-
-RasterBand
-~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.raster.RasterBand
-   :members:
-
-RasterExtension
-~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.raster.RasterExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-SAR Extension
--------------
-These classes are representations of the :stac-ext:`SAR Extension Spec
-<sar>`.
-
-FrequencyBand
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.FrequencyBand
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-Polarization
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.Polarization
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-ObservationDirection
-~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.ObservationDirection
-   :members:
-   :undoc-members:
-   :show-inheritance:
-
-SarExtension
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.SarExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-ItemSarExtension
-~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.ItemSarExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-AssetSarExtension
-~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sar.AssetSarExtension
-   :members:
-   :show-inheritance:
-   :inherited-members:
-
-Satellite Extension
--------------------
-These classes are representations of the :stac-ext:`Satellite Extension Spec
-<sat>`.
-
-OrbitState
-~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sat.OrbitState
-   :members:
-   :show-inheritance:
-   :undoc-members:
-
-SatExtension
-~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sat.SatExtension
-   :members:
-   :show-inheritance:
-
-ItemSatExtension
-~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sat.ItemSatExtension
-   :members:
-   :show-inheritance:
-
-AssetSatExtension
-~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sat.AssetSatExtension
-   :members:
-   :show-inheritance:
-
-SummariesSatExtension
-~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.sat.SummariesSatExtension
-   :members:
-   :show-inheritance:
-
-Scientific Extension
---------------------
-
-These classes are representations of the :stac-ext:`Scientific Extension Spec
-<scientific>`.
-
-Publication
-~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.scientific.Publication
-   :members:
-   :show-inheritance:
-
-ScientificExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.scientific.ScientificExtension
-   :members:
-   :show-inheritance:
-
-CollectionScientificExtension
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.scientific.CollectionScientificExtension
-   :members:
-   :show-inheritance:
-
-ItemScientificExtension
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.scientific.ItemScientificExtension
-   :members:
-   :show-inheritance:
-
-Table Extension
----------------
-
-These classes are representations of the :stac-ext:`Table Extension Spec <tables>`.
-
-TableExtension
-~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.table.TableExtension
-   :members:
-   :show-inheritance:
-
-CollectionTableExtension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.table.CollectionTableExtension
-   :members:
-   :show-inheritance:
-
-ItemTableExtension
-~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.table.ItemTableExtension
-   :members:
-   :show-inheritance:
-
-AssetTableExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.table.AssetTableExtension
-   :members:
-   :show-inheritance:
-
-Timestamps Extension
---------------------
-
-These classes are representations of the :stac-ext:`Timestamps Extension Spec
-<timestamps>`.
-
-TimestampsExtension
-~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.timestamps.TimestampsExtension
-   :members:
-   :show-inheritance:
-
-ItemTimestampsExtension
-~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.timestamps.ItemTimestampsExtension
-   :members:
-   :show-inheritance:
-
-AssetTimestampsExtension
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.timestamps.AssetTimestampsExtension
-   :members:
-   :show-inheritance:
-
-SAR Extension
--------------
-
-Implements the :stac-ext:`SAR Extension <sar>`.
-
-SarItemExt
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-**TEMPORARILY REMOVED**
-
-.. .. autoclass:: pystac.extensions.sar.SarItemExt
-..    :members:
-..    :undoc-members:
-..    :show-inheritance:
-
-SAT Extension
--------------
-
-Implements the :stac-ext:`SAT Extension <sat>`.
-
-SatItemExt
-~~~~~~~~~~~~~~~~~~~~~~~~
-
-**TEMPORARILY REMOVED**
-
-.. .. autoclass:: pystac.extensions.sar.SatItemExt
-..    :members:
-..    :undoc-members:
-..    :show-inheritance:
-
-Version Extension
------------------
-
-Implements the :stac-ext:`Versioning Indicators Extension <version>`.
-
-VersionRelType
-~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.version.VersionRelType
-   :members:
-   :show-inheritance:
-
-VersionExtension
-~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.version.VersionExtension
-   :members:
-   :show-inheritance:
-
-CollectionVersionExtension
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.version.CollectionVersionExtension
-   :members:
-   :show-inheritance:
-
-ItemVersionExtension
-~~~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.version.ItemVersionExtension
-   :members:
-   :show-inheritance:
-
-View Geometry Extension
------------------------
-
-These classes are representations of the :stac-ext:`View Geometry Extension Spec
-<view>`.
-
-ViewExtension
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.view.ViewExtension
-   :members:
-   :show-inheritance:
-
-ItemViewExtension
-~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.view.ItemViewExtension
-   :members:
-   :show-inheritance:
-
-AssetViewExtension
-~~~~~~~~~~~~~~~~~~
-
-.. autoclass:: pystac.extensions.view.AssetViewExtension
-   :members:
-   :show-inheritance:
+The following exceptions may be raised internally by the library.
+
+* :class:`pystac.STACError`: Generic STAC-related error
+* :class:`pystac.STACTypeError`: Raised when a representation of a STAC entity is
+  encountered that is not correct for the context
+* :class:`pystac.DuplicateObjectKeyError`: Raised when deserializing a JSON object
+  containing a duplicate key.
+* :class:`pystac.ExtensionAlreadyExistsError`: Raised when deserializing a JSON object
+  containing a duplicate key.
+* :class:`pystac.ExtensionTypeError`: Raised when an extension is used against an
+  object to which that the extension does not apply to.
+* :class:`pystac.ExtensionNotImplemented`: Raised on an attempt to extend a STAC object
+  that does not implement the given extension.
+* :class:`pystac.RequiredPropertyMissing`: Raised when a required value is expected to
+  be present but is missing or ``None``.
+* :class:`pystac.STACValidationError`: Raised by validation calls if the STAC JSON is
+  invalid.
+* :class:`pystac.layout.TemplateError`: Raised when an error occurs while converting a
+  template string into data for :class:`~pystac.layout.LayoutTemplate`.
 
 Serialization
 -------------
 
-PySTAC includes a ``pystac.serialization`` package for serialization concerns that
-are used internally, but may also be useful to external tools.
-
-Identification
-~~~~~~~~~~~~~~
+The ``pystac.serialization`` sub-package contains tools used internally by PySTAC to
+identify, serialize, and migrate STAC objects:
 
-.. automodule:: pystac.serialization
-   :members: identify_stac_object
-
-.. .. autoclass:: pystac.serialization.STACJSONDescription
-..    :members:
-..    :undoc-members:
-
-.. autoclass:: pystac.serialization.STACVersionRange
-   :members:
-   :undoc-members:
-
-.. .. autoclass:: pystac.serialization.STACVersionID
-..    :members:
-..    :undoc-members:
-
-
-Migration
-~~~~~~~~~
-
-.. automodule:: pystac.serialization.migrate
-   :members: migrate_to_latest
-
-Common Properties
-~~~~~~~~~~~~~~~~~
-
-.. automodule:: pystac.serialization
-   :members: merge_common_properties
+* :mod:`pystac.serialization.identify`: Tools for identifying STAC objects
+* :mod:`pystac.serialization.migrate`: Tools for migrating STAC objects from a previous
+  STAC Spec version.
 
 
 Validation
 ----------
 
-pystac.validation
-~~~~~~~~~~~~~~~~~
+.. note::
+
+    The tools described here require that you install PySTAC with the ``validation``
+    extra (see the documentation on :ref:`installing dependencies
+    <installation_dependencies>` for details).
 
 PySTAC includes a ``pystac.validation`` package for validating STAC objects, including
 from PySTAC objects and directly from JSON.
 
-.. automodule:: pystac.validation
-   :members: validate, validate_dict, validate_all, set_validator
-
-STACValidator
-~~~~~~~~~~~~~
-
-.. autoclass:: pystac.validation.STACValidator
-   :members:
-
-.. autoclass:: pystac.validation.JsonSchemaSTACValidator
-   :members:
-
-SchemaUriMap
-~~~~~~~~~~~~
-
-A ``SchemaMapUri`` defines methods for mapping STAC versions, object types and extension
-ids to schema URIs. A default implementation is included that uses known locations;
-however users can provide their own schema URI maps in a
-:class:`~pystac.validation.JsonSchemaSTACValidator` to modify the URIs used.
-
-.. .. autoclass:: pystac.validation.SchemaUriMap
-..    :members:
-
-.. autoclass:: pystac.validation.schema_uri_map.DefaultSchemaUriMap
-   :members:
-
-
-PySTAC Internal Classes
+* :class:`pystac.validation.stac_validator.STACValidator`: Abstract base class defining
+  methods for validating STAC JSON. Implementations define methods for validating core
+  objects and extension.
+* :class:`pystac.validation.stac_validator.JsonSchemaSTACValidator`: The default
+  :class:`~pystac.validation.stac_validator.STACValidator` implementation used by
+  PySTAC. Uses JSON schemas read from URIs provided by a
+  :class:`~pystac.validation.schema_uri_map.SchemaUriMap`, to validate STAC objects.
+* :class:`pystac.validation.schema_uri_map.SchemaUriMap`: Defines methods for mapping
+  STAC versions, object types and extension ids to schema URIs. A default
+  implementation is included that uses known locations; however users can provide their
+  own schema URI maps in a
+  :class:`~pystac.validation.stac_validator.JsonSchemaSTACValidator` to modify the URIs
+  used.
+* :class:`pystac.validation.schema_uri_map.DefaultSchemaUriMap`: The default
+  :class:`~pystac.validation.schema_uri_map.SchemaUriMap` used by PySTAC.
+
+Internal Classes
 -----------------------
 
-ResolvedObjectCache
-~~~~~~~~~~~~~~~~~~~
+These classes are used internally by PySTAC for caching.
 
-.. autoclass:: pystac.cache.ResolvedObjectCache
-   :members:
-   :undoc-members:
+* :class:`pystac.cache.ResolvedObjectCache`
diff --git a/docs/api/asset.rst b/docs/api/asset.rst
new file mode 100644
index 000000000..ab02001f2
--- /dev/null
+++ b/docs/api/asset.rst
@@ -0,0 +1,7 @@
+pystac.asset
+============
+
+.. automodule:: pystac.asset
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/cache.rst b/docs/api/cache.rst
new file mode 100644
index 000000000..cc0d2f2ab
--- /dev/null
+++ b/docs/api/cache.rst
@@ -0,0 +1,6 @@
+pystac.cache
+============
+
+.. automodule:: pystac.cache
+    :members:
+    :undoc-members:
diff --git a/docs/api/catalog.rst b/docs/api/catalog.rst
new file mode 100644
index 000000000..45c4bd1c8
--- /dev/null
+++ b/docs/api/catalog.rst
@@ -0,0 +1,7 @@
+pystac.catalog
+==============
+
+.. automodule:: pystac.catalog
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/collection.rst b/docs/api/collection.rst
new file mode 100644
index 000000000..d3728687b
--- /dev/null
+++ b/docs/api/collection.rst
@@ -0,0 +1,7 @@
+pystac.collection
+=================
+
+.. automodule:: pystac.collection
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/common_metadata.rst b/docs/api/common_metadata.rst
new file mode 100644
index 000000000..f3eb46a57
--- /dev/null
+++ b/docs/api/common_metadata.rst
@@ -0,0 +1,7 @@
+pystac.common_metadata
+======================
+
+.. automodule:: pystac.common_metadata
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/errors.rst b/docs/api/errors.rst
new file mode 100644
index 000000000..62f1ea18e
--- /dev/null
+++ b/docs/api/errors.rst
@@ -0,0 +1,7 @@
+pystac.errors
+=============
+
+.. automodule:: pystac.errors
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/extensions.rst b/docs/api/extensions.rst
new file mode 100644
index 000000000..14d4ec2e9
--- /dev/null
+++ b/docs/api/extensions.rst
@@ -0,0 +1,9 @@
+pystac.extensions
+=================
+
+.. toctree::
+    :hidden:
+    :maxdepth: 2
+    :glob:
+
+    extensions/*
diff --git a/docs/api/extensions/base.rst b/docs/api/extensions/base.rst
new file mode 100644
index 000000000..513ab5893
--- /dev/null
+++ b/docs/api/extensions/base.rst
@@ -0,0 +1,7 @@
+pytac.extensions.base
+=====================
+
+.. automodule:: pystac.extensions.base
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/datacube.rst b/docs/api/extensions/datacube.rst
new file mode 100644
index 000000000..97564ddb5
--- /dev/null
+++ b/docs/api/extensions/datacube.rst
@@ -0,0 +1,7 @@
+pystac.extensions.datacube
+==========================
+
+.. automodule:: pystac.extensions.datacube
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/eo.rst b/docs/api/extensions/eo.rst
new file mode 100644
index 000000000..829272559
--- /dev/null
+++ b/docs/api/extensions/eo.rst
@@ -0,0 +1,7 @@
+pystac.extensions.eo
+====================
+
+.. automodule:: pystac.extensions.eo
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/file.rst b/docs/api/extensions/file.rst
new file mode 100644
index 000000000..1d34d94b6
--- /dev/null
+++ b/docs/api/extensions/file.rst
@@ -0,0 +1,7 @@
+pystac.extensions.file
+======================
+
+.. automodule:: pystac.extensions.file
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/hooks.rst b/docs/api/extensions/hooks.rst
new file mode 100644
index 000000000..6e02d08d3
--- /dev/null
+++ b/docs/api/extensions/hooks.rst
@@ -0,0 +1,7 @@
+pystac.extensions.hooks
+=======================
+
+.. automodule:: pystac.extensions.hooks
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/item_assets.rst b/docs/api/extensions/item_assets.rst
new file mode 100644
index 000000000..e6003f3e4
--- /dev/null
+++ b/docs/api/extensions/item_assets.rst
@@ -0,0 +1,7 @@
+pystac.extensions.item\_assets
+==============================
+
+.. automodule:: pystac.extensions.item_assets
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/label.rst b/docs/api/extensions/label.rst
new file mode 100644
index 000000000..780abbf59
--- /dev/null
+++ b/docs/api/extensions/label.rst
@@ -0,0 +1,7 @@
+pystac.extensions.label
+=======================
+
+.. automodule:: pystac.extensions.label
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/pointcloud.rst b/docs/api/extensions/pointcloud.rst
new file mode 100644
index 000000000..749bfe482
--- /dev/null
+++ b/docs/api/extensions/pointcloud.rst
@@ -0,0 +1,7 @@
+pystac.extensions.pointcloud
+============================
+
+.. automodule:: pystac.extensions.pointcloud
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/projection.rst b/docs/api/extensions/projection.rst
new file mode 100644
index 000000000..6f7db1449
--- /dev/null
+++ b/docs/api/extensions/projection.rst
@@ -0,0 +1,7 @@
+pystac.extensions.projection
+============================
+
+.. automodule:: pystac.extensions.projection
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/raster.rst b/docs/api/extensions/raster.rst
new file mode 100644
index 000000000..a43ed37a9
--- /dev/null
+++ b/docs/api/extensions/raster.rst
@@ -0,0 +1,7 @@
+pystac.extensions.raster
+========================
+
+.. automodule:: pystac.extensions.raster
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/sar.rst b/docs/api/extensions/sar.rst
new file mode 100644
index 000000000..86da53983
--- /dev/null
+++ b/docs/api/extensions/sar.rst
@@ -0,0 +1,7 @@
+pystac.extensions.sar
+=====================
+
+.. automodule:: pystac.extensions.sar
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/sat.rst b/docs/api/extensions/sat.rst
new file mode 100644
index 000000000..e1c14807a
--- /dev/null
+++ b/docs/api/extensions/sat.rst
@@ -0,0 +1,7 @@
+pystac.extensions.sat
+=====================
+
+.. automodule:: pystac.extensions.sat
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/scientific.rst b/docs/api/extensions/scientific.rst
new file mode 100644
index 000000000..e3ee15a74
--- /dev/null
+++ b/docs/api/extensions/scientific.rst
@@ -0,0 +1,7 @@
+pystac.extensions.scientific
+============================
+
+.. automodule:: pystac.extensions.scientific
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/table.rst b/docs/api/extensions/table.rst
new file mode 100644
index 000000000..b1fe86bfc
--- /dev/null
+++ b/docs/api/extensions/table.rst
@@ -0,0 +1,7 @@
+pystac.extensions.table
+=======================
+
+.. automodule:: pystac.extensions.table
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/timestamps.rst b/docs/api/extensions/timestamps.rst
new file mode 100644
index 000000000..6b071b894
--- /dev/null
+++ b/docs/api/extensions/timestamps.rst
@@ -0,0 +1,7 @@
+pystac.extensions.timestamps
+============================
+
+.. automodule:: pystac.extensions.timestamps
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/version.rst b/docs/api/extensions/version.rst
new file mode 100644
index 000000000..08cb7f1bc
--- /dev/null
+++ b/docs/api/extensions/version.rst
@@ -0,0 +1,7 @@
+pystac.extensions.version
+=========================
+
+.. automodule:: pystac.extensions.version
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/extensions/view.rst b/docs/api/extensions/view.rst
new file mode 100644
index 000000000..42c3d31bb
--- /dev/null
+++ b/docs/api/extensions/view.rst
@@ -0,0 +1,7 @@
+pystac.extensions.view
+======================
+
+.. automodule:: pystac.extensions.view
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/item.rst b/docs/api/item.rst
new file mode 100644
index 000000000..921794cea
--- /dev/null
+++ b/docs/api/item.rst
@@ -0,0 +1,7 @@
+pystac.item
+===========
+
+.. automodule:: pystac.item
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/item_collection.rst b/docs/api/item_collection.rst
new file mode 100644
index 000000000..5958c289a
--- /dev/null
+++ b/docs/api/item_collection.rst
@@ -0,0 +1,7 @@
+pystac.item_collection
+======================
+
+.. automodule:: pystac.item_collection
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/layout.rst b/docs/api/layout.rst
new file mode 100644
index 000000000..08853cf26
--- /dev/null
+++ b/docs/api/layout.rst
@@ -0,0 +1,6 @@
+pystac.layout
+=============
+
+.. automodule:: pystac.layout
+    :members:
+    :undoc-members:
diff --git a/docs/api/link.rst b/docs/api/link.rst
new file mode 100644
index 000000000..85b1195b9
--- /dev/null
+++ b/docs/api/link.rst
@@ -0,0 +1,7 @@
+pystac.link
+===========
+
+.. automodule:: pystac.link
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/media_type.rst b/docs/api/media_type.rst
new file mode 100644
index 000000000..174f42d0c
--- /dev/null
+++ b/docs/api/media_type.rst
@@ -0,0 +1,7 @@
+pystac.media_type
+=================
+
+.. automodule:: pystac.media_type
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/provider.rst b/docs/api/provider.rst
new file mode 100644
index 000000000..b1f090e7d
--- /dev/null
+++ b/docs/api/provider.rst
@@ -0,0 +1,7 @@
+pystac.provider
+===============
+
+.. automodule:: pystac.provider
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/pystac.rst b/docs/api/pystac.rst
new file mode 100644
index 000000000..40b5fb9a6
--- /dev/null
+++ b/docs/api/pystac.rst
@@ -0,0 +1,184 @@
+pystac
+------
+
+.. automodule:: pystac
+   :members: read_file, write_file, read_dict, set_stac_version, get_stac_version
+
+STACObject
+----------
+
+.. autoclass:: pystac.STACObject
+   :members:
+   :inherited-members:
+   :undoc-members:
+
+.. autoclass:: pystac.STACObjectType
+   :members:
+   :undoc-members:
+
+Catalog
+-------
+
+.. autoclass:: pystac.Catalog
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+CatalogType
+-----------
+
+.. autoclass:: pystac.CatalogType
+   :members:
+   :inherited-members:
+   :undoc-members:
+
+Collection
+----------
+
+.. autoclass:: pystac.Collection
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Extent
+------
+
+.. autoclass:: pystac.Extent
+   :members:
+   :undoc-members:
+
+SpatialExtent
+-------------
+
+.. autoclass:: pystac.SpatialExtent
+   :members:
+   :undoc-members:
+
+TemporalExtent
+--------------
+
+.. autoclass:: pystac.TemporalExtent
+   :members:
+   :undoc-members:
+
+ProviderRole
+------------
+
+.. autoclass:: pystac.ProviderRole
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Provider
+--------
+
+.. autoclass:: pystac.Provider
+   :members:
+   :undoc-members:
+
+Summaries
+---------
+
+.. autoclass:: pystac.Summaries
+   :members:
+   :undoc-members:
+
+Item
+----
+
+.. autoclass:: pystac.Item
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+Asset
+-----
+
+.. autoclass:: pystac.Asset
+   :members:
+   :undoc-members:
+
+CommonMetadata
+--------------
+
+.. autoclass:: pystac.CommonMetadata
+   :members:
+   :undoc-members:
+
+ItemCollection
+--------------
+
+.. autoclass:: pystac.ItemCollection
+   :members:
+   :show-inheritance:
+
+Link
+----
+
+.. autoclass:: pystac.Link
+   :members:
+   :undoc-members:
+
+MediaType
+---------
+
+.. autoclass:: pystac.MediaType
+   :members:
+   :undoc-members:
+
+RelType
+-------
+
+.. autoclass:: pystac.RelType
+   :members:
+   :undoc-members:
+
+StacIO
+------
+
+.. autoclass:: pystac.StacIO
+   :members:
+   :undoc-members:
+
+Errors
+------
+
+STACError
+~~~~~~~~~
+
+.. autoclass:: pystac.STACError
+
+STACTypeError
+~~~~~~~~~~~~~
+
+.. autoclass:: pystac.STACTypeError
+
+DuplicateObjectKeyError
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.DuplicateObjectKeyError
+
+ExtensionAlreadyExistsError
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.ExtensionAlreadyExistsError
+
+ExtensionTypeError
+~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.ExtensionTypeError
+
+ExtensionNotImplemented
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.ExtensionNotImplemented
+
+RequiredPropertyMissing
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.RequiredPropertyMissing
+
+STACValidationError
+~~~~~~~~~~~~~~~~~~~
+
+.. autoclass:: pystac.STACValidationError
diff --git a/docs/api/rel_type.rst b/docs/api/rel_type.rst
new file mode 100644
index 000000000..a13c99f86
--- /dev/null
+++ b/docs/api/rel_type.rst
@@ -0,0 +1,7 @@
+pystac.rel_type
+===============
+
+.. automodule:: pystac.rel_type
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/serialization.rst b/docs/api/serialization.rst
new file mode 100644
index 000000000..4a21bea46
--- /dev/null
+++ b/docs/api/serialization.rst
@@ -0,0 +1,12 @@
+pystac.serialization
+====================
+
+.. toctree::
+    :hidden:
+    :maxdepth: 2
+    :glob:
+
+    serialization/*
+
+.. automodule:: pystac.serialization
+    :members:
diff --git a/docs/api/serialization/common_properties.rst b/docs/api/serialization/common_properties.rst
new file mode 100644
index 000000000..0ed7fb557
--- /dev/null
+++ b/docs/api/serialization/common_properties.rst
@@ -0,0 +1,7 @@
+pystac.serialization.common\_properties
+=======================================
+
+.. automodule:: pystac.serialization.common_properties
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/serialization/identify.rst b/docs/api/serialization/identify.rst
new file mode 100644
index 000000000..adbff0a9e
--- /dev/null
+++ b/docs/api/serialization/identify.rst
@@ -0,0 +1,7 @@
+pystac.serialization.identify
+=============================
+
+.. automodule:: pystac.serialization.identify
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/serialization/migrate.rst b/docs/api/serialization/migrate.rst
new file mode 100644
index 000000000..272a24dfe
--- /dev/null
+++ b/docs/api/serialization/migrate.rst
@@ -0,0 +1,7 @@
+pystac.serialization.migrate
+============================
+
+.. automodule:: pystac.serialization.migrate
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/stac_io.rst b/docs/api/stac_io.rst
new file mode 100644
index 000000000..611d276f0
--- /dev/null
+++ b/docs/api/stac_io.rst
@@ -0,0 +1,6 @@
+pystac.stac_io
+==============
+
+.. automodule:: pystac.stac_io
+    :members:
+    :undoc-members:
diff --git a/docs/api/stac_object.rst b/docs/api/stac_object.rst
new file mode 100644
index 000000000..1b94928a9
--- /dev/null
+++ b/docs/api/stac_object.rst
@@ -0,0 +1,7 @@
+pystac.stac_object
+==================
+
+.. automodule:: pystac.stac_object
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/summaries.rst b/docs/api/summaries.rst
new file mode 100644
index 000000000..7a2358f08
--- /dev/null
+++ b/docs/api/summaries.rst
@@ -0,0 +1,7 @@
+pystac.summaries
+================
+
+.. automodule:: pystac.summaries
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/utils.rst b/docs/api/utils.rst
new file mode 100644
index 000000000..4ce4f8d35
--- /dev/null
+++ b/docs/api/utils.rst
@@ -0,0 +1,7 @@
+pystac.utils
+============
+
+.. automodule:: pystac.utils
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/api/validation.rst b/docs/api/validation.rst
new file mode 100644
index 000000000..4b73d714b
--- /dev/null
+++ b/docs/api/validation.rst
@@ -0,0 +1,12 @@
+pystac.validation
+=================
+
+.. toctree::
+    :hidden:
+    :maxdepth: 2
+    :glob:
+
+    validation/*
+
+.. automodule:: pystac.validation
+    :members:
diff --git a/docs/api/validation/schema_uri_map.rst b/docs/api/validation/schema_uri_map.rst
new file mode 100644
index 000000000..83ceece89
--- /dev/null
+++ b/docs/api/validation/schema_uri_map.rst
@@ -0,0 +1,7 @@
+pystac.validation.schema\_uri\_map
+==================================
+
+.. automodule:: pystac.validation.schema_uri_map
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/validation/stac_validator.rst b/docs/api/validation/stac_validator.rst
new file mode 100644
index 000000000..d8aef85ba
--- /dev/null
+++ b/docs/api/validation/stac_validator.rst
@@ -0,0 +1,7 @@
+pystac.validation.stac\_validator
+=================================
+
+.. automodule:: pystac.validation.stac_validator
+   :members:
+   :undoc-members:
+   :show-inheritance:
diff --git a/docs/api/version.rst b/docs/api/version.rst
new file mode 100644
index 000000000..ea856258f
--- /dev/null
+++ b/docs/api/version.rst
@@ -0,0 +1,7 @@
+pystac.version
+==============
+
+.. automodule:: pystac.version
+    :members:
+    :undoc-members:
+    :noindex:
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 6db632b9e..8d2ac863d 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -4,6 +4,24 @@ Concepts
 This page will give an overview of some important concepts to understand when working
 with PySTAC. If you want to check code examples, see the :ref:`tutorials`.
 
+.. _stac_version_support:
+
+STAC Spec Version Support
+=========================
+
+The latest version of PySTAC supports STAC Spec |stac_version| and will automatically
+update any catalogs to this version. To work with older versions of the STAC Spec,
+please use an older version of PySTAC:
+
+=================  ==============
+STAC Spec Version  PySTAC Version
+=================  ==============
+>=1.0                Latest
+0.9                0.4.*
+0.8                0.3.*
+<0.8               *Not supported*
+=================  ==============
+
 Reading STACs
 =============
 
@@ -318,6 +336,9 @@ to take advantage of connection pooling using a `requests.Session
 
    StacIO.set_default(ConnectionPoolingIO)
 
+
+.. _validation_concepts:
+
 Validation
 ==========
 
@@ -427,9 +448,9 @@ classes that extend these objects inherit from
 :class:`pystac.extensions.base.PropertiesExtension`, and you can use the
 ``ext`` method on these classes to extend an object.
 
-For instance, to extend an item with the :stac-ext:`Electro-Optical Extension <eo>`
-you would use :meth:`EOExtension.ext <pystac.extensions.eo.EOExtension.ext>` as
-follows:
+For instance, if you have an item that implements the :stac-ext:`Electro-Optical
+Extension <eo>`, you can access the properties associated with that extension using
+:meth:`EOExtension.ext <pystac.extensions.eo.EOExtension.ext>`:
 
 .. code-block:: python
 
@@ -437,14 +458,22 @@ follows:
    from pystac.extensions.eo import EOExtension
 
    item = Item(...)  # See docs for creating an Item
-   eo_ext = EOExtension.ext(item)
 
-This extended instance now gives you access to the properties defined in that extension:
+   # Check that the Item implements the EO Extension
+   if EOExtension.has_extension(item):
+      eo_ext = EOExtension.ext(item)
 
-.. code-block:: python
+      bands = eo_ext.bands
+      cloud_cover = eo_ext.cloud_cover
+      ...
 
-   eo_ext.bands
-   eo_ext.cloud_cover
+.. note:: The ``ext`` method will raise an :exc:`~pystac.ExtensionNotImplemented`
+   exception if the object does not implement that extension (e.g. if the extension
+   URI is not in that object's :attr:`~pystac.STACObject.stac_extensions` list). In
+   the example above, we check that the Item implements the EO Extension before calling
+   :meth:`EOExtension.ext <pystac.extensions.eo.EOExtension.ext>` to handle this. See
+   the `Adding an Extension`_ section below for details on adding an extension to an
+   object.
 
 See the documentation for each extension implementation for details on the supported
 properties and other functionality.
@@ -492,6 +521,7 @@ have a default value of ``None``:
 If you attempt to extend an object that is not supported by an extension, PySTAC will
 throw a :class:`pystac.ExtensionTypeError`.
 
+
 Adding an Extension
 -------------------
 
diff --git a/docs/conf.py b/docs/conf.py
index 20974c96f..3bdd208e8 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -15,7 +15,7 @@
 import os
 import sys
 import subprocess
-from typing import Any, Dict
+from typing import Any, Dict, List
 
 sys.path.insert(0, os.path.abspath("."))
 sys.path.insert(0, os.path.abspath("../"))
@@ -49,13 +49,13 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    "sphinx_panels",
     "sphinx.ext.autodoc",
     "sphinx.ext.viewcode",
     "sphinx.ext.intersphinx",
     "sphinx.ext.napoleon",
     "sphinx.ext.githubpages",
     "sphinx.ext.extlinks",
-    "sphinxcontrib.fulltoc",
     "nbsphinx",
 ]
 
@@ -76,6 +76,9 @@
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
+# Static CSS files
+html_css_files = ["custom.css"]
+
 # The suffix(es) of source filenames.
 # You can specify multiple suffix as a list of string:
 #
@@ -106,25 +109,38 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "alabaster"
+html_theme = "pydata_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
 # documentation.
 #
 html_theme_options = {
-    "show_powered_by": False,
-    "github_user": "stac-utils",
-    "github_repo": "pystac",
-    "github_banner": True,
-    "show_related": False,
-    "note_bg": "#FFF59C",
+    "icon_links": [
+        {
+            "name": "GitHub",
+            "url": "https://github.com/stac-utils/pystac",
+            "icon": "fab fa-github-square",
+        },
+        {
+            "name": "Gitter",
+            "url": "https://gitter.im/SpatioTemporal-Asset-Catalog/"
+            "python?utm_source=share-link&utm_medium=link&utm_campaign=share-link",
+            "icon": "fab fa-gitter",
+        },
+    ],
+    "external_links": [
+        {"name": "STAC Spec", "url": "https://github.com/radiantearth/stac-spec"}
+    ],
+    # "navbar_end": ["navbar-icon-links.html", "search-field.html"]
 }
 
+html_logo = "_static/STAC-03.png"
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # 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_static_path = ["_static"]
 
 # Custom sidebar templates, must be a dictionary that maps document names
 # to template names.
@@ -134,7 +150,7 @@
 # default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
 # 'searchbox.html']``.
 #
-# html_sidebars = {}
+html_sidebars: Dict[str, List[str]] = {"index": []}
 
 
 # -- Options for HTMLHelp output ---------------------------------------------
@@ -216,3 +232,7 @@
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
 }
+
+# -- Substutition variables
+
+rst_epilog = f".. |stac_version| replace:: {STACVersion.DEFAULT_STAC_VERSION}"
diff --git a/docs/example-catalog/catalog.json b/docs/example-catalog/catalog.json
new file mode 100644
index 000000000..e7366d659
--- /dev/null
+++ b/docs/example-catalog/catalog.json
@@ -0,0 +1,22 @@
+{
+  "type": "Catalog",
+  "stac_version": "1.0.0",
+  "stac_extensions": [],
+  "id": "landsat-stac-collection-catalog",
+  "title": "STAC for Landsat data",
+  "description": "STAC for Landsat data",
+  "links": [
+    {
+      "href": "./catalog.json",
+      "rel": "self"
+    },
+    {
+      "href": "./catalog.json",
+      "rel": "root"
+    },
+    {
+      "href": "./landsat-8-l1/collection.json",
+      "rel": "child"
+    }
+  ]
+}
\ No newline at end of file
diff --git a/docs/example-catalog/landsat-8-l1/2018-05/LC80150322018141LGN00.json b/docs/example-catalog/landsat-8-l1/2018-05/LC80150322018141LGN00.json
new file mode 100644
index 000000000..cd98208ba
--- /dev/null
+++ b/docs/example-catalog/landsat-8-l1/2018-05/LC80150322018141LGN00.json
@@ -0,0 +1,276 @@
+{
+  "type": "Feature",
+  "id": "LC80150322018141LGN00",
+  "stac_version" : "1.0.0",
+  "stac_extensions" : [
+    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "bbox": [
+    -77.88298,
+    39.23073,
+    -75.07535,
+    41.41022
+  ],
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -77.28911976020206,
+          41.40912394323429
+        ],
+        [
+          -75.07576783500748,
+          40.97162247589133
+        ],
+        [
+          -75.66872631473827,
+          39.23210949585851
+        ],
+        [
+          -77.87946700654118,
+          39.67679918442899
+        ],
+        [
+          -77.28911976020206,
+          41.40912394323429
+        ]
+      ]
+    ]
+  },
+  "collection": "landsat-8-l1",
+  "properties": {
+    "collection": "landsat-8-l1",
+    "datetime": "2018-05-21T15:44:59Z",
+    "view:sun_azimuth": 134.8082647,
+    "view:sun_elevation": 64.00406717,
+    "eo:cloud_cover": 4,
+    "instruments": ["OLI_TIRS"],
+    "view:off_nadir": 0,
+    "platform": "landsat-8",
+    "gsd": 30,
+    "proj:epsg": 32618,
+    "proj:transform": [258885.0, 30.0, 0.0, 4584315.0, 0.0, -30.0],
+    "proj:geometry": {
+      "type": "Polygon",
+      "coordinates": [
+        [
+          [258885.0, 4346085.0],
+          [258885.0, 4584315.0],
+          [493515.0, 4584315.0],
+          [493515.0, 4346085.0],
+          [258885.0, 4346085.0]
+        ]
+      ]
+    },
+    "proj:shape": [7821, 7941]
+  },
+  "assets": {
+    "index": {
+      "type": "text/html",
+      "title": "HTML index page",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/index.html",
+      "roles": []
+    },
+    "thumbnail": {
+      "title": "Thumbnail image",
+      "type": "image/jpeg",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_thumb_large.jpg",
+      "roles" : [
+        "thumbnail"
+      ]
+    },
+    "B1": {
+      "type": "image/tiff",
+      "title": "Band 1 (coastal)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B1.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B1",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 0.44,
+          "common_name" : "coastal"
+        }
+      ]
+    },
+    "B2": {
+      "type": "image/tiff",
+      "title": "Band 2 (blue)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B2.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B2",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.48,
+          "common_name" : "blue"
+        }
+      ]
+    },
+    "B3": {
+      "type": "image/tiff",
+      "title": "Band 3 (green)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B3.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B3",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.56,
+          "common_name" : "green"
+        }
+      ]
+    },
+    "B4": {
+      "type": "image/tiff",
+      "title": "Band 4 (red)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B4.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B4",
+          "full_width_half_max" : 0.04,
+          "center_wavelength" : 0.65,
+          "common_name" : "red"
+        }
+      ]
+    },
+    "B5": {
+      "type": "image/tiff",
+      "title": "Band 5 (nir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B5.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B5",
+          "full_width_half_max" : 0.03,
+          "center_wavelength" : 0.86,
+          "common_name" : "nir"
+        }
+      ]
+    },
+    "B6": {
+      "type": "image/tiff",
+      "title": "Band 6 (swir16)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B6.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B6",
+          "full_width_half_max" : 0.08,
+          "center_wavelength" : 1.6,
+          "common_name" : "swir16"
+        }
+      ]
+    },
+    "B7": {
+      "type": "image/tiff",
+      "title": "Band 7 (swir22)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B7.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B7",
+          "full_width_half_max" : 0.22,
+          "center_wavelength" : 2.2,
+          "common_name" : "swir22"
+        }
+      ]
+    },
+    "B8": {
+      "type": "image/tiff",
+      "title": "Band 8 (pan)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B8.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B8",
+          "full_width_half_max" : 0.18,
+          "center_wavelength" : 0.59,
+          "common_name" : "pan"
+        }
+      ]
+    },
+    "B9": {
+      "type": "image/tiff",
+      "title": "Band 9 (cirrus)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B9.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B9",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 1.37,
+          "common_name" : "cirrus"
+        }
+      ]
+    },
+    "B10": {
+      "type": "image/tiff",
+      "title": "Band 10 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B10.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B10",
+          "full_width_half_max" : 0.8,
+          "center_wavelength" : 10.9,
+          "common_name" : "lwir11"
+        }
+      ]
+    },
+    "B11": {
+      "type": "image/tiff",
+      "title": "Band 11 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_B11.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B11",
+          "full_width_half_max" : 1,
+          "center_wavelength" : 12,
+          "common_name" : "lwir2"
+        }
+      ]
+    },
+    "ANG": {
+      "title": "Angle coefficients file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_ANG.txt",
+      "roles": []
+    },
+    "MTL": {
+      "title": "original metadata file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_MTL.txt",
+      "roles": []
+    },
+    "BQA": {
+      "title": "Band quality data",
+      "type": "image/tiff",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1TP_015032_20180521_20180605_01_T1/LC08_L1TP_015032_20180521_20180605_01_T1_BQA.TIF",
+      "roles": []
+    }
+  },
+  "links": [
+    {
+      "rel": "self",
+      "href": "./LC80150322018141LGN00.json"
+    },
+    {
+      "rel": "parent",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "collection",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "root",
+      "href": "../../catalog.json"
+    }
+  ]
+}
diff --git a/docs/example-catalog/landsat-8-l1/2018-06/LC80140332018166LGN00.json b/docs/example-catalog/landsat-8-l1/2018-06/LC80140332018166LGN00.json
new file mode 100644
index 000000000..492328337
--- /dev/null
+++ b/docs/example-catalog/landsat-8-l1/2018-06/LC80140332018166LGN00.json
@@ -0,0 +1,276 @@
+{
+  "type": "Feature",
+  "id": "LC80140332018166LGN00",
+  "stac_version" : "1.0.0",
+  "stac_extensions" : [
+    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "bbox": [
+    -76.66703,
+    37.82561,
+    -73.94861,
+    39.95958
+  ],
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -76.12180471942207,
+          39.95810181489563
+        ],
+        [
+          -73.94910518227414,
+          39.55117185146004
+        ],
+        [
+          -74.49564725552679,
+          37.826064511480496
+        ],
+        [
+          -76.66550404911956,
+          38.240699151776084
+        ],
+        [
+          -76.12180471942207,
+          39.95810181489563
+        ]
+      ]
+    ]
+  },
+  "collection": "landsat-8-l1",
+  "properties": {
+    "collection": "landsat-8-l1",
+    "datetime": "2018-06-15T15:39:09Z",
+    "view:sun_azimuth": 125.59055137,
+    "view:sun_elevation": 66.54485226,
+    "eo:cloud_cover": 22,
+    "instruments": ["OLI_TIRS"],
+    "view:off_nadir": 0,
+    "platform": "landsat-8",
+    "gsd": 30,
+    "proj:epsg": 32618,
+    "proj:transform": [357585.0, 30.0, 0.0, 4423815.0, 0.0, -30.0],
+    "proj:geometry": {
+      "type": "Polygon",
+      "coordinates": [
+        [
+          [357585.0, 4187685.0],
+          [357585.0, 4423815.0],
+          [589815.0, 4423815.0],
+          [589815.0, 4187685.0],
+          [357585.0, 4187685.0]
+        ]
+      ]
+    },
+    "proj:shape": [7741, 7871]
+  },
+  "assets": {
+    "index": {
+      "type": "text/html",
+      "title": "HTML index page",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/index.html",
+      "roles": []
+    },
+    "thumbnail": {
+      "title": "Thumbnail image",
+      "type": "image/jpeg",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_thumb_large.jpg",
+      "roles" : [
+        "thumbnail"
+      ]
+    },
+    "B1": {
+      "type": "image/tiff",
+      "title": "Band 1 (coastal)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B1.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B1",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 0.44,
+          "common_name" : "coastal"
+        }
+      ]
+    },
+    "B2": {
+      "type": "image/tiff",
+      "title": "Band 2 (blue)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B2.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B2",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.48,
+          "common_name" : "blue"
+        }
+      ]
+    },
+    "B3": {
+      "type": "image/tiff",
+      "title": "Band 3 (green)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B3.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B3",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.56,
+          "common_name" : "green"
+        }
+      ]
+    },
+    "B4": {
+      "type": "image/tiff",
+      "title": "Band 4 (red)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B4.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B4",
+          "full_width_half_max" : 0.04,
+          "center_wavelength" : 0.65,
+          "common_name" : "red"
+        }
+      ]
+    },
+    "B5": {
+      "type": "image/tiff",
+      "title": "Band 5 (nir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B5.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B5",
+          "full_width_half_max" : 0.03,
+          "center_wavelength" : 0.86,
+          "common_name" : "nir"
+        }
+      ]
+    },
+    "B6": {
+      "type": "image/tiff",
+      "title": "Band 6 (swir16)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B6.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B6",
+          "full_width_half_max" : 0.08,
+          "center_wavelength" : 1.6,
+          "common_name" : "swir16"
+        }
+      ]
+    },
+    "B7": {
+      "type": "image/tiff",
+      "title": "Band 7 (swir22)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B7.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B7",
+          "full_width_half_max" : 0.22,
+          "center_wavelength" : 2.2,
+          "common_name" : "swir22"
+        }
+      ]
+    },
+    "B8": {
+      "type": "image/tiff",
+      "title": "Band 8 (pan)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B8.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B8",
+          "full_width_half_max" : 0.18,
+          "center_wavelength" : 0.59,
+          "common_name" : "pan"
+        }
+      ]
+    },
+    "B9": {
+      "type": "image/tiff",
+      "title": "Band 9 (cirrus)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B9.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B9",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 1.37,
+          "common_name" : "cirrus"
+        }
+      ]
+    },
+    "B10": {
+      "type": "image/tiff",
+      "title": "Band 10 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B10.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B10",
+          "full_width_half_max" : 0.8,
+          "center_wavelength" : 10.9,
+          "common_name" : "lwir11"
+        }
+      ]
+    },
+    "B11": {
+      "type": "image/tiff",
+      "title": "Band 11 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B11.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B11",
+          "full_width_half_max" : 1,
+          "center_wavelength" : 12,
+          "common_name" : "lwir2"
+        }
+      ]
+    },
+    "ANG": {
+      "title": "Angle coefficients file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_ANG.txt",
+      "roles": []
+    },
+    "MTL": {
+      "title": "original metadata file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_MTL.txt",
+      "roles": []
+    },
+    "BQA": {
+      "title": "Band quality data",
+      "type": "image/tiff",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_BQA.TIF",
+      "roles": []
+    }
+  },
+  "links": [
+    {
+      "rel": "self",
+      "href": "./LC80140332018166LGN00.json"
+    },
+    {
+      "rel": "parent",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "collection",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "root",
+      "href": "../../catalog.json"
+    }
+  ]
+}
diff --git a/docs/example-catalog/landsat-8-l1/2018-06/LC80300332018166LGN00.json b/docs/example-catalog/landsat-8-l1/2018-06/LC80300332018166LGN00.json
new file mode 100644
index 000000000..ea69c22ed
--- /dev/null
+++ b/docs/example-catalog/landsat-8-l1/2018-06/LC80300332018166LGN00.json
@@ -0,0 +1,276 @@
+{
+  "type": "Feature",
+  "stac_version" : "1.0.0",
+  "stac_extensions" : [
+    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "id": "LC80300332018166LGN00",
+  "bbox": [
+    -101.40793,
+    37.81084,
+    -98.6721,
+    39.97469
+  ],
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -100.84368079413701,
+          39.97210491033466
+        ],
+        [
+          -98.67492641719046,
+          39.54833037653145
+        ],
+        [
+          -99.23946071016417,
+          37.81370881408165
+        ],
+        [
+          -101.40560438472555,
+          38.24476872678675
+        ],
+        [
+          -100.84368079413701,
+          39.97210491033466
+        ]
+      ]
+    ]
+  },
+  "collection": "landsat-8-l1",
+  "properties": {
+    "collection": "landsat-8-l1",
+    "datetime": "2018-06-15T17:18:03Z",
+    "view:sun_azimuth": 125.5799919,
+    "view:sun_elevation": 66.54407242,
+    "eo:cloud_cover": 0,
+    "instruments": ["OLI_TIRS"],
+    "view:off_nadir": 0,
+    "platform": "landsat-8",
+    "gsd": 30,
+    "proj:epsg": 32614,
+    "proj:transform": [294285.0, 30.0, 0.0, 4425015.0, 0.0, -30],
+    "proj:geometry": {
+      "type": "Polygon",
+      "coordinates": [
+        [
+          [294285.0, 4187385.0],
+          [294285.0, 4425015.0],
+          [528015.0, 4425015.0],
+          [528015.0, 4187385.0],
+          [294285.0, 4187385.0]
+        ]
+      ]
+    },
+    "proj:shape": [7791, 7921]
+  },
+  "assets": {
+    "index": {
+      "type": "text/html",
+      "title": "HTML index page",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/index.html",
+      "roles" : []
+    },
+    "thumbnail": {
+      "title": "Thumbnail image",
+      "type": "image/jpeg",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_thumb_large.jpg",
+      "roles" : [
+        "thumbnail"
+      ]
+    },
+    "B1": {
+      "type": "image/tiff",
+      "title": "Band 1 (coastal)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B1.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B1",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 0.44,
+          "common_name" : "coastal"
+        }
+      ]
+    },
+    "B2": {
+      "type": "image/tiff",
+      "title": "Band 2 (blue)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B2.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B2",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.48,
+          "common_name" : "blue"
+        }
+      ]
+    },
+    "B3": {
+      "type": "image/tiff",
+      "title": "Band 3 (green)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B3.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B3",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.56,
+          "common_name" : "green"
+        }
+      ]
+    },
+    "B4": {
+      "type": "image/tiff",
+      "title": "Band 4 (red)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B4.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B4",
+          "full_width_half_max" : 0.04,
+          "center_wavelength" : 0.65,
+          "common_name" : "red"
+        }
+      ]
+    },
+    "B5": {
+      "type": "image/tiff",
+      "title": "Band 5 (nir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B5.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B5",
+          "full_width_half_max" : 0.03,
+          "center_wavelength" : 0.86,
+          "common_name" : "nir"
+        }
+      ]
+    },
+    "B6": {
+      "type": "image/tiff",
+      "title": "Band 6 (swir16)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B6.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B6",
+          "full_width_half_max" : 0.08,
+          "center_wavelength" : 1.6,
+          "common_name" : "swir16"
+        }
+      ]
+    },
+    "B7": {
+      "type": "image/tiff",
+      "title": "Band 7 (swir22)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B7.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B7",
+          "full_width_half_max" : 0.22,
+          "center_wavelength" : 2.2,
+          "common_name" : "swir22"
+        }
+      ]
+    },
+    "B8": {
+      "type": "image/tiff",
+      "title": "Band 8 (pan)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B8.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B8",
+          "full_width_half_max" : 0.18,
+          "center_wavelength" : 0.59,
+          "common_name" : "pan"
+        }
+      ]
+    },
+    "B9": {
+      "type": "image/tiff",
+      "title": "Band 9 (cirrus)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B9.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B9",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 1.37,
+          "common_name" : "cirrus"
+        }
+      ]
+    },
+    "B10": {
+      "type": "image/tiff",
+      "title": "Band 10 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B10.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B10",
+          "full_width_half_max" : 0.8,
+          "center_wavelength" : 10.9,
+          "common_name" : "lwir11"
+        }
+      ]
+    },
+    "B11": {
+      "type": "image/tiff",
+      "title": "Band 11 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_B11.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B11",
+          "full_width_half_max" : 1,
+          "center_wavelength" : 12,
+          "common_name" : "lwir2"
+        }
+      ]
+    },
+    "ANG": {
+      "title": "Angle coefficients file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_ANG.txt",
+      "roles": []
+    },
+    "MTL": {
+      "title": "original metadata file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_MTL.txt",
+      "roles": []
+    },
+    "BQA": {
+      "title": "Band quality data",
+      "type": "image/tiff",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/030/033/LC08_L1TP_030033_20180615_20180703_01_T1/LC08_L1TP_030033_20180615_20180703_01_T1_BQA.TIF",
+      "roles": []
+    }
+  },
+  "links": [
+    {
+      "rel": "self",
+      "href": "./LC80300332018166LGN00.json"
+    },
+    {
+      "rel": "parent",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "collection",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "root",
+      "href": "../../catalog.json"
+    }
+  ]
+}
diff --git a/docs/example-catalog/landsat-8-l1/2018-07/LC80150332018189LGN00.json b/docs/example-catalog/landsat-8-l1/2018-07/LC80150332018189LGN00.json
new file mode 100644
index 000000000..0ea395487
--- /dev/null
+++ b/docs/example-catalog/landsat-8-l1/2018-07/LC80150332018189LGN00.json
@@ -0,0 +1,275 @@
+{
+  "type": "Feature",
+  "id": "LC80150332018189LGN00",
+  "stac_version" : "1.0.0",
+  "stac_extensions" : [
+    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
+    "https://stac-extensions.github.io/projection/v1.0.0/schema.json"
+  ],
+  "bbox": [
+    -78.25028,
+    37.79719,
+    -75.48983,
+    39.98757
+  ],
+  "geometry": {
+    "type": "Polygon",
+    "coordinates": [
+      [
+        [
+          -77.66532657556414,
+          39.987421383364385
+        ],
+        [
+          -75.49021499188945,
+          39.54442448711656
+        ],
+        [
+          -76.07747288135147,
+          37.799167045362736
+        ],
+        [
+          -78.25025639728777,
+          38.24897728816149
+        ],
+        [
+          -77.66532657556414,
+          39.987421383364385
+        ]
+      ]
+    ]
+  },
+  "collection": "landsat-8-l1",
+  "properties": {
+    "collection": "landsat-8-l1",
+    "datetime": "2018-07-08T15:45:34Z",
+    "view:sun_azimuth": 125.31095515,
+    "view:sun_elevation": 65.2014335,
+    "eo:cloud_cover": 0,
+    "instruments": ["OLI_TIRS"],
+    "view:off_nadir": 0,
+    "platform": "landsat-8",
+    "gsd": 30,
+    "proj:epsg": 32618,
+    "proj:transform": [222285.0, 30.0, 0.0, 4426515.0, 0.0, -30.0],
+    "proj:geometry": {
+      "type": "Polygon",
+      "coordinates": [
+        [
+          [222285.0, 4187985.0],
+          [222285.0, 4426515.0],
+          [456915.0, 4426515.0],
+          [456915.0, 4187985.0],
+          [222285.0,4187985.0]]
+      ]
+    },
+    "proj:shape": [7821, 7951]
+  },
+  "assets": {
+    "index": {
+      "type": "text/html",
+      "title": "HTML index page",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/index.html",
+      "roles": []
+    },
+    "thumbnail": {
+      "title": "Thumbnail image",
+      "type": "image/jpeg",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_thumb_large.jpg",
+      "roles" : [
+        "thumbnail"
+      ]
+    },
+    "B1": {
+      "type": "image/tiff",
+      "title": "Band 1 (coastal)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B1.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B1",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 0.44,
+          "common_name" : "coastal"
+        }
+      ]
+    },
+    "B2": {
+      "type": "image/tiff",
+      "title": "Band 2 (blue)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B2.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B2",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.48,
+          "common_name" : "blue"
+        }
+      ]
+    },
+    "B3": {
+      "type": "image/tiff",
+      "title": "Band 3 (green)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B3.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B3",
+          "full_width_half_max" : 0.06,
+          "center_wavelength" : 0.56,
+          "common_name" : "green"
+        }
+      ]
+    },
+    "B4": {
+      "type": "image/tiff",
+      "title": "Band 4 (red)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B4.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B4",
+          "full_width_half_max" : 0.04,
+          "center_wavelength" : 0.65,
+          "common_name" : "red"
+        }
+      ]
+    },
+    "B5": {
+      "type": "image/tiff",
+      "title": "Band 5 (nir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B5.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B5",
+          "full_width_half_max" : 0.03,
+          "center_wavelength" : 0.86,
+          "common_name" : "nir"
+        }
+      ]
+    },
+    "B6": {
+      "type": "image/tiff",
+      "title": "Band 6 (swir16)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B6.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B6",
+          "full_width_half_max" : 0.08,
+          "center_wavelength" : 1.6,
+          "common_name" : "swir16"
+        }
+      ]
+    },
+    "B7": {
+      "type": "image/tiff",
+      "title": "Band 7 (swir22)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B7.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B7",
+          "full_width_half_max" : 0.22,
+          "center_wavelength" : 2.2,
+          "common_name" : "swir22"
+        }
+      ]
+    },
+    "B8": {
+      "type": "image/tiff",
+      "title": "Band 8 (pan)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B8.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B8",
+          "full_width_half_max" : 0.18,
+          "center_wavelength" : 0.59,
+          "common_name" : "pan"
+        }
+      ]
+    },
+    "B9": {
+      "type": "image/tiff",
+      "title": "Band 9 (cirrus)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B9.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B9",
+          "full_width_half_max" : 0.02,
+          "center_wavelength" : 1.37,
+          "common_name" : "cirrus"
+        }
+      ]
+    },
+    "B10": {
+      "type": "image/tiff",
+      "title": "Band 10 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B10.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B10",
+          "full_width_half_max" : 0.8,
+          "center_wavelength" : 10.9,
+          "common_name" : "lwir11"
+        }
+      ]
+    },
+    "B11": {
+      "type": "image/tiff",
+      "title": "Band 11 (lwir)",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_B11.TIF",
+      "roles": [],
+      "eo:bands": [
+        {
+          "name" : "B11",
+          "full_width_half_max" : 1,
+          "center_wavelength" : 12,
+          "common_name" : "lwir2"
+        }
+      ]
+    },
+    "ANG": {
+      "title": "Angle coefficients file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_ANG.txt",
+      "roles": []
+    },
+    "MTL": {
+      "title": "original metadata file",
+      "type": "text/plain",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_MTL.txt",
+      "roles": []
+    },
+    "BQA": {
+      "title": "Band quality data",
+      "type": "image/tiff",
+      "href": "https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/033/LC08_L1TP_015033_20180708_20180717_01_T1/LC08_L1TP_015033_20180708_20180717_01_T1_BQA.TIF",
+      "roles": []
+    }
+  },
+  "links": [
+    {
+      "rel": "self",
+      "href": "./LC80150332018189LGN00.json"
+    },
+    {
+      "rel": "parent",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "collection",
+      "href": "../collection.json"
+    },
+    {
+      "rel": "root",
+      "href": "../../catalog.json"
+    }
+  ]
+}
diff --git a/docs/example-catalog/landsat-8-l1/collection.json b/docs/example-catalog/landsat-8-l1/collection.json
new file mode 100644
index 000000000..a1ecff367
--- /dev/null
+++ b/docs/example-catalog/landsat-8-l1/collection.json
@@ -0,0 +1,156 @@
+{
+  "type": "Collection",
+  "stac_version" : "1.0.0",
+  "stac_extensions" : [
+    "eo",
+    "view",
+    "https://example.com/stac/landsat-extension/1.0/schema.json"
+  ],
+  "id" : "landsat-8-l1",
+  "title" : "Landsat 8 L1",
+  "description" : "Landat 8 imagery radiometrically calibrated and orthorectified using gound points and Digital Elevation Model (DEM) data to correct relief displacement.",
+  "keywords" : [
+    "landsat",
+    "earth observation",
+    "usgs"
+  ],
+  "license" : "proprietary",
+  "providers" : [
+    {
+      "name" : "Development Seed",
+      "roles" : [
+        "processor"
+      ],
+      "url" : "https://github.com/sat-utils/sat-api"
+    }
+  ],
+  "extent" : {
+    "spatial" : {
+      "bbox" : [
+        [
+          -180.0,
+          -90.0,
+          180.0,
+          90.0
+        ]
+      ]
+    },
+    "temporal" : {
+      "interval" : [
+        [
+          "2018-05-21T15:44:59Z",
+          "2018-07-08T15:45:34Z"
+        ]
+      ]
+    }
+  },
+  "summaries": {},
+  "properties" : {
+    "collection" : "landsat-8-l1",
+    "instruments" : ["OLI_TIRS"],
+    "view:sun_azimuth" : 149.01607154,
+    "eo:bands" : [
+      {
+        "name" : "B1",
+        "full_width_half_max" : 0.02,
+        "center_wavelength" : 0.44,
+        "common_name" : "coastal"
+      },
+      {
+        "name" : "B2",
+        "full_width_half_max" : 0.06,
+        "center_wavelength" : 0.48,
+        "common_name" : "blue"
+      },
+      {
+        "name" : "B3",
+        "full_width_half_max" : 0.06,
+        "center_wavelength" : 0.56,
+        "common_name" : "green"
+      },
+      {
+        "name" : "B4",
+        "full_width_half_max" : 0.04,
+        "center_wavelength" : 0.65,
+        "common_name" : "red"
+      },
+      {
+        "name" : "B5",
+        "full_width_half_max" : 0.03,
+        "center_wavelength" : 0.86,
+        "common_name" : "nir"
+      },
+      {
+        "name" : "B6",
+        "full_width_half_max" : 0.08,
+        "center_wavelength" : 1.6,
+        "common_name" : "swir16"
+      },
+      {
+        "name" : "B7",
+        "full_width_half_max" : 0.22,
+        "center_wavelength" : 2.2,
+        "common_name" : "swir22"
+      },
+      {
+        "name" : "B8",
+        "full_width_half_max" : 0.18,
+        "center_wavelength" : 0.59,
+        "common_name" : "pan"
+      },
+      {
+        "name" : "B9",
+        "full_width_half_max" : 0.02,
+        "center_wavelength" : 1.37,
+        "common_name" : "cirrus"
+      },
+      {
+        "name" : "B10",
+        "full_width_half_max" : 0.8,
+        "center_wavelength" : 10.9,
+        "common_name" : "lwir11"
+      },
+      {
+        "name" : "B11",
+        "full_width_half_max" : 1,
+        "center_wavelength" : 12,
+        "common_name" : "lwir2"
+      }
+    ],
+    "view:off_nadir" : 0,
+    "view:azimuth" : 0,
+    "platform" : "landsat-8",
+    "gsd" : 15,
+    "view:sun_elevation" : 59.214247
+  },
+  "links" : [
+    {
+      "href" : "../catalog.json",
+      "rel" : "root"
+    },
+    {
+      "href" : "../catalog.json",
+      "rel" : "parent"
+    },
+    {
+      "href" : "./collection.json",
+      "rel" : "self"
+    },
+    {
+      "href" : "./2018-06/LC80140332018166LGN00.json",
+      "rel" : "item"
+    },
+    {
+      "href" : "./2018-05/LC80150322018141LGN00.json",
+      "rel" : "item"
+    },
+    {
+      "href" : "./2018-07/LC80150332018189LGN00.json",
+      "rel" : "item"
+    },
+    {
+      "href" : "./2018-06/LC80300332018166LGN00.json",
+      "rel" : "item"
+    }
+  ]
+}
diff --git a/docs/index.rst b/docs/index.rst
index ceb986bc5..d4d991943 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,50 +1,64 @@
 PySTAC Documentation
 ####################
 
-PySTAC is a library for working with `SpatioTemporal Asset Catalogs (STAC) <https://stacspec.org/>`_.
+PySTAC is a library for working with `SpatioTemporal Asset Catalogs (STAC)
+<https://stacspec.org/>`_ in `Python 3 <https://www.python.org/>`_. Some nice features
+of PySTAC are:
 
-Requirements
-============
-* `Python 3 <https://www.python.org/>`_
+* Reading and writing STAC version 1.0. Future versions will read older versions of
+  STAC, but always write the latest supported version. See :ref:`stac_version_support`
+  for details.
+* In-memory manipulations of STAC catalogs.
+* Extend the I/O of STAC metadata to provide support for other platforms (e.g. cloud
+  providers).
+* Easy, efficient crawling of STAC catalogs. STAC objects are only read in when needed.
+* Easily write "absolute published", "relative published" and "self-contained" catalogs
+  as :stac-spec:`described in the best practices documentation
+  <best-practices.md#use-of-links>`.
 
-STAC Versions
-=============
+.. raw:: html
 
-* 0.5 -> STAC Version 1.0
-* 0.4 -> STAC Version 0.9
-* 0.3 -> STAC Version 0.8
+    <form class="bd-search align-items-center" action="search.html" method="get">
+      <input type="search" class="form-control" name="q" id="search-input" placeholder="&#128269; Search the docs ..." aria-label="Search the docs ..." autocomplete="off">
+    </form>
 
-Standard pip install
-====================
+.. panels::
 
-.. code-block:: bash
+    Get Started
+    ^^^^^^^^^^^
 
-   pip install pystac
+    * :doc:`installation`: Instructions for installing the basic package as well as
+      extras.
+    * :doc:`quickstart`: Jupyter notebook tutorial on using PySTAC for reading &
+      writing STAC catalogs.
 
-PySTAC Features
-===============
+    ---
 
-* Reads and writes STAC version 0.8. Future versions will read older versions of STAC,
-  but always write one version.
-* Allows in-memory manipulations of STAC catalogs.
-* Allows users to extend the IO of STAC metadata to provide support e.g. cloud
-  providers.
-* Allows easy iteration over STAC objects. STAC objects are only read in when needed.
-* Allows users to easily write "absolute published", "relative published" and
-  "self-contained" catalogs as :stac-spec:`described in the best practices documentation
-  <best-practices.md#use-of-links>`.
+    Go Deeper
+    ^^^^^^^^^
 
-Acknowledgments
-================
+    * :doc:`concepts`: Overview of how various concepts and structures from the STAC
+      Specification are implemented within PySTAC.
+    * :doc:`tutorials`: In-depth tutorials on using PySTAC for a number of different
+      applications.
+    * :doc:`api`: Detailed API documentation of PySTAC classes, methods, and functions.
 
-This library builds on the code and concepts of `sat-stac <https://github.com/sat-utils/sat-stac>`_.
+Related Projects
+================
 
-Table of Contents
-=================
+* `pystac-client <https://github.com/stac-utils/pystac-client>`__: A Python client for
+  working with STAC Catalogs and APIs.
+* `stactools <https://github.com/stac-utils/stactools>`__: A command line tool and
+  library for working with STAC.
+* `sat-stac <https://github.com/sat-utils/sat-stac>`__: A Python 3 library for reading
+  and working with existing Spatio-Temporal Asset Catalogs (STAC). *Much of PySTAC
+  builds on the code and concepts of* ``sat-stac``.
 
 .. toctree::
    :maxdepth: 2
+   :hidden:
 
+   installation
    quickstart
    concepts
    api
diff --git a/docs/installation.rst b/docs/installation.rst
new file mode 100644
index 000000000..101a931c9
--- /dev/null
+++ b/docs/installation.rst
@@ -0,0 +1,61 @@
+Installation
+############
+
+Install from PyPi (recommended)
+===============================
+
+.. code-block:: bash
+
+    pip install pystac
+
+Install from conda-forge
+========================
+
+.. code-block:: bash
+
+    conda install -c conda-forge pystac
+
+Install from source
+===================
+
+.. code-block:: bash
+
+    pip install git+https://github.com/stac-utils/pystac.git
+
+.. _installation_dependencies:
+
+Dependencies
+=============
+
+As a foundational component of the Python STAC ecosystem used in a number of downstream
+libraries, PySTAC aims to minimize its dependencies. As a result, the only dependency
+for the basic PySTAC library is `python-dateutil
+<https://dateutil.readthedocs.io/en/stable/>`__.
+
+PySTAC also has the following extras, which can be optionally installed to provide
+additional functionality:
+
+* ``validation``
+
+  Installs the additional `jsonschema
+  <https://python-jsonschema.readthedocs.io/en/latest/>`__ dependency. When this
+  dependency is installed, the :ref:`validation methods <validation_concepts>` may be
+  used to validate STAC objects against the appropriate JSON schemas.
+
+  To install:
+
+  .. code-block:: bash
+
+      pip install pystac[validation]
+
+* ``orjson``
+
+  Installs the additional `orjson <https://github.com/ijl/orjson>`__ dependency. When
+  this dependency is installed, `orjson` will be used as the default JSON
+  serialization/deserialization for all operations in PySTAC.
+
+  To install:
+
+  .. code-block:: bash
+
+      pip install pystac[orjson]
diff --git a/docs/quickstart.ipynb b/docs/quickstart.ipynb
index d4b3fcad3..2894db2fd 100644
--- a/docs/quickstart.ipynb
+++ b/docs/quickstart.ipynb
@@ -6,23 +6,24 @@
    "source": [
     "# Quickstart\n",
     "\n",
-    "This notebook shows how to use PySTAC to read through the public Sentinel catalog and write a local version."
-   ]
-  },
-  {
-   "cell_type": "markdown",
-   "metadata": {},
-   "source": [
-    "### Reading STAC"
+    "This notebook is a quick introduction to using PySTAC for reading an existing STAC catalog. For more in-depth examples check out the other tutorials.\n",
+    "\n",
+    "## Dependencies\n",
+    "\n",
+    "- PySTAC"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "First, we want to hook into PySTAC to allow for reading of HTTP STAC items, as described in [the STAC_IO Concepts docs](concepts.html#using-stac-io). \n",
+    "## Reading a Catalog\n",
+    "\n",
+    "[A STAC Catalog](https://github.com/radiantearth/stac-spec/tree/master/catalog-spec) is used to group other STAC objects like Items, Collections, or even other Catalogs.\n",
+    "\n",
+    "We will be using a small example catalog adapted from the [example Landsat Collection](https://github.com/geotrellis/geotrellis-server/tree/977bad7a64c409341479c281c8c72222008861fd/stac-example/catalog/landsat-stac-collection) in the [GeoTrellis](https://geotrellis.io) repository. All STAC Items and Collections can be found in the [docs/example-catalog](https://github.com/stac-utils/pystac/tree/main/docs/example-catalog) directory of this repo; all Assets are hosted in the Landsat S3 bucket.\n",
     "\n",
-    "__Note:__ this requires the [requests](https://requests.kennethreitz.org/en/master) library be installed."
+    "First, we import the PySTAC classes we will be working with."
    ]
   },
   {
@@ -31,43 +32,53 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "from urllib.parse import urlparse\n",
-    "import requests\n",
-    "from pystac import STAC_IO\n",
+    "import json\n",
+    "import shutil\n",
+    "import tempfile\n",
+    "from datetime import date\n",
+    "from pathlib import Path\n",
     "\n",
-    "def requests_read_method(uri):\n",
-    "    parsed = urlparse(uri)\n",
-    "    if parsed.scheme.startswith('http'):\n",
-    "        return requests.get(uri).text\n",
-    "    else:\n",
-    "        return STAC_IO.default_read_text_method(uri)\n",
-    "\n",
-    "STAC_IO.read_text_method = requests_read_method"
+    "from pystac import Catalog, get_stac_version\n",
+    "from pystac.extensions.eo import EOExtension\n",
+    "from pystac.extensions.label import LabelExtension"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can then read the STAC catalog located at the publicly available endpoint hosted by AWS:"
+    "Next, we read the example catalog and print some basic metadata."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 2,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "ID: landsat-stac-collection-catalog\n",
+      "Title: STAC for Landsat data\n",
+      "Description: STAC for Landsat data\n"
+     ]
+    }
+   ],
    "source": [
-    "from pystac import Catalog\n",
-    "\n",
-    "cat = Catalog.from_file('https://sentinel-stac.s3.amazonaws.com/catalog.json')"
+    "root_catalog = Catalog.from_file('./example-catalog/catalog.json')\n",
+    "print(f\"ID: {root_catalog.id}\")\n",
+    "print(f\"Title: {root_catalog.title or 'N/A'}\")\n",
+    "print(f\"Description: {root_catalog.description or 'N/A'}\")"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "There are a lot of items in this catalog; crawling through it all would take a significant amount of time. Here, we lean on the fact that [link resolution is lazy](concepts.html#lazy-resolution-of-stac-objects) and get to a catalog that contains items:"
+    "*Note that we do not print the \"stac_version\" here. PySTAC automatically updates any Catalogs to the most recent supported STAC version and will automatically write this to the JSON object during serialization.*\n",
+    "\n",
+    "Let's confirm the latest STAC Spec version supported by PySTAC."
    ]
   },
   {
@@ -79,24 +90,23 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Crawling through <Catalog id=sentinel-stac>\n",
-      "Crawling through <Collection id=sentinel-2-l1c>\n",
-      "Crawling through <Catalog id=9>\n",
-      "Crawling through <Catalog id=V>\n"
+      "1.0.0\n"
      ]
     }
    ],
    "source": [
-    "while len(cat.get_item_links()) == 0:\n",
-    "    print('Crawling through {}'.format(cat))\n",
-    "    cat = next(cat.get_children())"
+    "print(get_stac_version())"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can print some information about the catalog, including how many children it has:"
+    "## Crawling Child Catalogs/Collections\n",
+    "\n",
+    "[STAC Collections](https://github.com/radiantearth/stac-spec/tree/master/collection-spec) are used to group related Items and provide aggregate or summary metadata for those Items.\n",
+    "\n",
+    "STAC Catalogs may have many nested layers of Catalogs or Collections within the top-level collection. Our example catalog has one Collection within the main Catalog at [landsat-8-l1/collection.json](./example-catalog/landsat-8-l1/collection.json). We can list the Collections in a given Catalog using the [Catalog.get_collections](https://pystac.readthedocs.io/en/latest/api.html#pystac.Catalog.get_collections) method. This method returns an iterable of PySTAC [Collection](https://pystac.readthedocs.io/en/latest/api.html#collection) instances, which we will turn into a `list`."
    ]
   },
   {
@@ -108,21 +118,26 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "XK catalog\n",
-      "Contains 388 items.\n"
+      "Number of collections: 1\n",
+      "Collections IDs:\n",
+      "- landsat-8-l1\n"
      ]
     }
    ],
    "source": [
-    "print(cat.description)\n",
-    "print('Contains {} items.'.format(len(cat.get_item_links())))"
+    "collections = list(root_catalog.get_collections())\n",
+    "\n",
+    "print(f\"Number of collections: {len(collections)}\")\n",
+    "print(\"Collections IDs:\")\n",
+    "for collection in collections:\n",
+    "    print(f\"- {collection.id}\")"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Let's grab the first item., check out it's cloud cover, and start exploring the assets."
+    "Let's grab that Collection as a PySTAC [Collection](https://pystac.readthedocs.io/en/latest/api.html#collection) instance using the [Catalog.get_child method](https://pystac.readthedocs.io/en/latest/api.html#pystac.Catalog.get_child) so we can look at it in more detail. This method gets a child Catalog or Collection by ID, so we'll use the Collection ID that we printed above. Since this method returns `None` if no child exists with the given ID, we'll check to make sure we actually got the `Collection`."
    ]
   },
   {
@@ -131,496 +146,660 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "item = next(cat.get_items())"
+    "collection = root_catalog.get_child(\"landsat-8-l1\")\n",
+    "assert collection is not None"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "You can access [common metadata](https://github.com/radiantearth/stac-spec/blob/v0.9.0/item-spec/common-metadata.md) fields through the common_metadata property of the item:"
+    "## Crawling Items\n",
+    "\n",
+    "[STAC Items](https://github.com/radiantearth/stac-spec/tree/master/item-spec) are the fundamental building blocks of a STAC Catalog. Each Item represents a single spatiotemporal resource (e.g. a satellite scene).\n",
+    "\n",
+    "Both Catalogs and Collections may have Items associated with them. Let's crawl our catalog, starting at the root, to see what Items we have. The [Catalog.get_all_items method](https://pystac.readthedocs.io/en/latest/api.html#pystac.Catalog.get_all_items) provides a convenient way of recursively listing all Items associated with a Catalog and all of its sub-Catalogs."
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 6,
    "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Number of items: 4\n",
+      "- LC80140332018166LGN00\n",
+      "- LC80150322018141LGN00\n",
+      "- LC80150332018189LGN00\n",
+      "- LC80300332018166LGN00\n"
+     ]
+    }
+   ],
+   "source": [
+    "items = list(root_catalog.get_all_items())\n",
+    "\n",
+    "print(f\"Number of items: {len(items)}\")\n",
+    "for item in items:\n",
+    "    print(f\"- {item.id}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "These IDs are not very descriptive; in the next section, we will take a look at how we can access the rich metadata associated with each Item."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Item Metadata\n",
+    "\n",
+    "Items can have *a lot* of metadata. This can be a bit overwhelming at first, but break the metadata fields down into a few categories:\n",
+    "\n",
+    "- Core Item Metadata\n",
+    "- Common Metadata\n",
+    "- STAC Extensions\n",
+    "\n",
+    "We will walk through each of these metadata categories in the following sections. \n",
+    "\n",
+    "First, let's grab one of the Items using the [Catalog.get_item method](https://pystac.readthedocs.io/en/latest/api.html#pystac.Catalog.get_item). We will use `recursive=True` to recursively crawl all child Catalogs and/or Collections to find the Item."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "item = root_catalog.get_item(\"LC80140332018166LGN00\", recursive=True)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### Core Item Metadata\n",
+    "\n",
+    "The core Item metadata fields include spatiotemporal information and the ID of the collection to which the Item belongs. These fields are all at the top level of the Item JSON and we can access them through attributes on the [PySTAC Item](https://pystac.readthedocs.io/en/latest/api.html#item) instance."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "'sentinel-2b'"
+       "{'type': 'Polygon',\n",
+       " 'coordinates': [[[-76.12180471942207, 39.95810181489563],\n",
+       "   [-73.94910518227414, 39.55117185146004],\n",
+       "   [-74.49564725552679, 37.826064511480496],\n",
+       "   [-76.66550404911956, 38.240699151776084],\n",
+       "   [-76.12180471942207, 39.95810181489563]]]}"
       ]
      },
-     "execution_count": 6,
+     "execution_count": 8,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "item.common_metadata.platform"
+    "item.geometry"
    ]
   },
   {
-   "cell_type": "markdown",
+   "cell_type": "code",
+   "execution_count": 9,
    "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[-76.66703, 37.82561, -73.94861, 39.95958]"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
-    "This particular stac item implements the [eo extension](https://github.com/radiantearth/stac-spec/tree/v0.9.0/extensions/eo) extension. We can access the extension information through the \"ext\" property that's part of every Catalog, Collection and Item. For instance, to get the cloud cover, we can use:"
+    "item.bbox"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 10,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "41.52"
+       "datetime.datetime(2018, 6, 15, 15, 39, 9, tzinfo=tzutc())"
       ]
      },
-     "execution_count": 7,
+     "execution_count": 10,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "item.ext.eo.cloud_cover"
+    "item.datetime"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'landsat-8-l1'"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "item.collection_id"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "we can see the cloud cover is in it's appropriate key in the Item's properties:"
+    "If we want the actual `Collection` instance instead of just the ID, we can use the [Item.get_collection](https://pystac.readthedocs.io/en/latest/api.html#pystac.Item.get_collection) method."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": 12,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "41.52"
+       "<Collection id=landsat-8-l1>"
       ]
      },
-     "execution_count": 8,
+     "execution_count": 12,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "item.properties['eo:cloud_cover']"
+    "item.get_collection()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "if we want to set the cloud cover, we can do that through the extension as well:"
+    "### Common Metadata\n",
+    "\n",
+    "Certain fields that are commonly used in Items, but may also be found in other objects (e.g. Assets) are defined in the [Common Metadata](https://github.com/radiantearth/stac-spec/blob/v1.0.0/item-spec/common-metadata.md) section of the spec. These include licensing and instrument information, descriptions of datetime ranges, and some other common fields. These properties can be found as attributes of the `Item.common_metadata` property, which is an instance of the [CommonMetadata class](https://pystac.readthedocs.io/en/latest/api.html#pystac.CommonMetadata)."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 13,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "42.0"
+       "['OLI_TIRS']"
       ]
      },
-     "execution_count": 9,
+     "execution_count": 13,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "item.ext.eo.cloud_cover = 42.0\n",
-    "item.properties['eo:cloud_cover']"
+    "item.common_metadata.instruments"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'landsat-8'"
+      ]
+     },
+     "execution_count": 14,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "item.common_metadata.platform"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "30"
+      ]
+     },
+     "execution_count": 15,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "item.common_metadata.gsd"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can access the item's assets through the assets property, which is a dictionary:"
+    "### STAC Extensions\n",
+    "\n",
+    "[STAC Extensions](https://github.com/radiantearth/stac-spec/tree/master/extensions) are a mechanism for providing additional metadata not covered by the core STAC Spec. We can see which STAC Extensions are implemented by this particular Item by examining the list of extension URIs in the `stac_extensions` field."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 16,
    "metadata": {},
    "outputs": [
     {
-     "name": "stdout",
-     "output_type": "stream",
-     "text": [
-      "thumbnail: https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/13/0/preview.jpg (None)\n",
-      "info: https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/13/0/tileInfo.json (None)\n",
-      "metadata: https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/13/0/metadata.xml (None)\n",
-      "tki: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/TKI.jp2 (image/jp2)\n",
-      "B01: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B01.jp2 (image/jp2)\n",
-      "B02: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B02.jp2 (image/jp2)\n",
-      "B03: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B03.jp2 (image/jp2)\n",
-      "B04: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B04.jp2 (image/jp2)\n",
-      "B05: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B05.jp2 (image/jp2)\n",
-      "B06: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B06.jp2 (image/jp2)\n",
-      "B07: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B07.jp2 (image/jp2)\n",
-      "B08: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B08.jp2 (image/jp2)\n",
-      "B8A: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B08.jp2 (image/jp2)\n",
-      "B09: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B09.jp2 (image/jp2)\n",
-      "B10: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B10.jp2 (image/jp2)\n",
-      "B11: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B11.jp2 (image/jp2)\n",
-      "B12: https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B11.jp2 (image/jp2)\n"
-     ]
+     "data": {
+      "text/plain": [
+       "['https://stac-extensions.github.io/eo/v1.0.0/schema.json',\n",
+       " 'https://stac-extensions.github.io/view/v1.0.0/schema.json',\n",
+       " 'https://stac-extensions.github.io/projection/v1.0.0/schema.json']"
+      ]
+     },
+     "execution_count": 16,
+     "metadata": {},
+     "output_type": "execute_result"
     }
    ],
    "source": [
-    "for asset_key in item.assets:\n",
-    "    asset = item.assets[asset_key]\n",
-    "    print('{}: {} ({})'.format(asset_key, asset.href, asset.media_type))"
+    "item.stac_extensions"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can use the `to_dict()` method to convert an Asset, or any PySTAC object, into a dictionary:"
+    "This Item implements the [Electro-Optical](https://github.com/stac-extensions/eo), [View Geometry](https://github.com/stac-extensions/view), and [Projection](https://github.com/stac-extensions/projection) Extensions. \n",
+    "\n",
+    "We can also check if a specific extension is implemented using the [has_extension](https://pystac.readthedocs.io/en/latest/api.html#pystac.extensions.base.ExtensionManagementMixin.has_extension) method for that extension class."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": 17,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{'href': 'https://sentinel-s2-l1c.s3.amazonaws.com/tiles/9/V/XK/2017/10/13/0/B03.jp2',\n",
-       " 'type': 'image/jp2',\n",
-       " 'title': 'Band 3 (green)',\n",
-       " 'eo:bands': [{'name': 'B03',\n",
-       "   'common_name': 'green',\n",
-       "   'gsd': 10.0,\n",
-       "   'center_wavelength': 0.56,\n",
-       "   'full_width_half_max': 0.045}]}"
+       "True"
       ]
      },
-     "execution_count": 11,
+     "execution_count": 17,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "asset = item.assets['B03']\n",
-    "asset.to_dict()"
+    "EOExtension.has_extension(item)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "False"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "LabelExtension.has_extension(item)"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Here we use the eo extension to get the band information for the asset:"
+    "We can access fields associated with the extension as attributes on the extension instance. For instance, the [\"eo:cloud_cover\" field](https://github.com/stac-extensions/eo#item-properties-or-asset-fields) defined in the Electro-Optical Extension can be accessed using the [EOExtension.cloud_cover](https://pystac.readthedocs.io/en/latest/api.html#pystac.extensions.eo.EOExtension.cloud_cover) attribute."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 19,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "[<Band name=B03>]"
+       "22"
       ]
      },
-     "execution_count": 12,
+     "execution_count": 19,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "bands = item.ext.eo.get_bands(asset)\n",
-    "bands"
+    "eo_item_ext = EOExtension.ext(item)\n",
+    "eo_item_ext.cloud_cover"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We can also access the cloud cover field directly in the Item properties."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 13,
+   "execution_count": 20,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{'name': 'B03',\n",
-       " 'common_name': 'green',\n",
-       " 'gsd': 10.0,\n",
-       " 'center_wavelength': 0.56,\n",
-       " 'full_width_half_max': 0.045}"
+       "22"
       ]
      },
-     "execution_count": 13,
+     "execution_count": 20,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "bands[0].to_dict()"
+    "item.properties['eo:cloud_cover']"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Writing a STAC\n",
-    "\n",
-    "Let's walk the catalog again, but this time create local clones of the STAC object, so we can end up with a copy that we can save off to the local file system."
+    "We can access the Item's assets through the `assets` attribute, which is a dictionary:"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 14,
+   "execution_count": 21,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Crawling through <Catalog id=sentinel-stac>\n",
-      "Crawling through <Collection id=sentinel-2-l1c>\n",
-      "Crawling through <Catalog id=9>\n",
-      "Crawling through <Catalog id=V>\n"
+      "index: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/index.html (text/html)\n",
+      "thumbnail: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_thumb_large.jpg (image/jpeg)\n",
+      "B1: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B1.TIF (image/tiff)\n",
+      "B2: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B2.TIF (image/tiff)\n",
+      "B3: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B3.TIF (image/tiff)\n",
+      "B4: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B4.TIF (image/tiff)\n",
+      "B5: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B5.TIF (image/tiff)\n",
+      "B6: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B6.TIF (image/tiff)\n",
+      "B7: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B7.TIF (image/tiff)\n",
+      "B8: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B8.TIF (image/tiff)\n",
+      "B9: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B9.TIF (image/tiff)\n",
+      "B10: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B10.TIF (image/tiff)\n",
+      "B11: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B11.TIF (image/tiff)\n",
+      "ANG: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_ANG.txt (text/plain)\n",
+      "MTL: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_MTL.txt (text/plain)\n",
+      "BQA: https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_BQA.TIF (image/tiff)\n"
      ]
     }
    ],
    "source": [
-    "import itertools\n",
-    "\n",
-    "cat = Catalog.from_file('https://sentinel-stac.s3.amazonaws.com/catalog.json')\n",
-    "\n",
-    "# Setup the root of our local STAC\n",
-    "local_root = cat.clone()\n",
-    "local_root.clear_children()\n",
-    "\n",
-    "# Loop over catalogs and clone\n",
-    "curr_local_cat = local_root\n",
-    "while len(cat.get_item_links()) == 0:\n",
-    "    print('Crawling through {}'.format(cat))\n",
-    "    cat = next(cat.get_children())\n",
-    "    local_cat = cat.clone()\n",
-    "    local_cat.clear_children()\n",
-    "    curr_local_cat.add_child(local_cat)\n",
-    "    curr_local_cat = local_cat\n",
-    "    \n",
-    "# Clear the items from the last local catalog\n",
-    "curr_local_cat.clear_children()\n",
-    "curr_local_cat.clear_items()\n",
-    "\n",
-    "# Take the first 5 items\n",
-    "items = itertools.islice(cat.get_items(), 5)\n",
-    "\n",
-    "# Clone and add them to our local catalog\n",
-    "curr_local_cat.add_items([i.clone() for i in items])"
+    "for asset_key in item.assets:\n",
+    "    asset = item.assets[asset_key]\n",
+    "    print('{}: {} ({})'.format(asset_key, asset.href, asset.media_type))"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "Now that we have a smaller STAC, let's map over the items to reduce it even further by only including the thumbnail assets in our items:"
+    "We can use the `to_dict()` method to convert an Asset, or any PySTAC object, into a dictionary:"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 15,
+   "execution_count": 22,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "{'href': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/014/033/LC08_L1TP_014033_20180615_20180703_01_T1/LC08_L1TP_014033_20180615_20180703_01_T1_B3.TIF',\n",
+       " 'type': 'image/tiff',\n",
+       " 'title': 'Band 3 (green)',\n",
+       " 'eo:bands': [{'name': 'B3',\n",
+       "   'full_width_half_max': 0.06,\n",
+       "   'center_wavelength': 0.56,\n",
+       "   'common_name': 'green'}],\n",
+       " 'roles': []}"
+      ]
+     },
+     "execution_count": 22,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
-    "def item_mapper(item):\n",
-    "    thumbnail_asset = item.assets['thumbnail']\n",
-    "    \n",
-    "    new_assets = { \n",
-    "        k:v \n",
-    "        for k, v in item.assets.items()\n",
-    "        if k == 'thumbnail'\n",
-    "    }\n",
-    "    item.assets = new_assets\n",
-    "    return item\n",
-    "\n",
-    "local_root_2 = local_root.map_items(item_mapper)\n",
-    "    "
+    "asset = item.assets['B3']\n",
+    "asset.to_dict()"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "We can now normalize our catalog and save it somewhere local:"
+    "Here we use the eo extension to get the band information for the asset:"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 16,
+   "execution_count": 23,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[<Band name=B3>]"
+      ]
+     },
+     "execution_count": 23,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
-    "!mkdir -p ./quickstart_stac"
+    "eo_asset_ext = EOExtension.ext(asset)\n",
+    "bands = eo_asset_ext.bands\n",
+    "bands"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 17,
+   "execution_count": 24,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "<Catalog id=sentinel-stac>"
+       "{'name': 'B3',\n",
+       " 'full_width_half_max': 0.06,\n",
+       " 'center_wavelength': 0.56,\n",
+       " 'common_name': 'green'}"
       ]
      },
-     "execution_count": 17,
+     "execution_count": 24,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "local_root_2.normalize_hrefs('./quickstart_stac')"
+    "bands[0].to_dict()"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Writing STAC Objects\n",
+    "\n",
+    "We can also use PySTAC to create and/or update STAC objects and write them to disk. This Quickstart Tutorial will introduce you to some very basic concepts in writing STAC objects; for a more thorough tutorial, please see the [\"How to create STAC Catalogs\"](./tutorials/how-to-create-stac-catalogs.ipynb) tutorial.\n",
+    "\n",
+    "Suppose there was a mistake in the cloud cover value that we looked at earlier and that we would like to add a value for the `instrument` field, which is currently null. We can update these values using the same attributes and properties as before, then save the entire catalog to our local drive."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 18,
+   "execution_count": 25,
    "metadata": {},
    "outputs": [],
    "source": [
-    "from pystac import CatalogType\n",
+    "new_catalog = root_catalog.clone()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 26,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "item_to_update = root_catalog.get_item(\"LC80140332018166LGN00\", recursive=True)\n",
+    "item_to_update_eo_ext = EOExtension.ext(item_to_update)\n",
     "\n",
-    "local_root_2.save(catalog_type=CatalogType.SELF_CONTAINED)"
+    "# Update the cloud cover\n",
+    "item_to_update_eo_ext.cloud_cover = 30\n",
+    "\n",
+    "# Add the instrument field\n",
+    "item_to_update.common_metadata.instruments = [\"LANDSAT\"]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "Now we can examine the Item properties directly to verify that the changes have taken effect."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 19,
+   "execution_count": 27,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "* <Catalog id=sentinel-stac>\n",
-      "    * <Collection id=sentinel-2-l1c>\n",
-      "        * <Catalog id=9>\n",
-      "            * <Catalog id=V>\n",
-      "                * <Catalog id=XK>\n",
-      "                  * <Item id=S2B_9VXK_20171013_0>\n",
-      "                  * <Item id=S2A_9VXK_20171015_0>\n",
-      "                  * <Item id=S2B_9VXK_20171016_0>\n",
-      "                  * <Item id=S2B_9VXK_20171017_0>\n",
-      "                  * <Item id=S2A_9VXK_20171002_0>\n"
+      "New Cloud Cover: 30\n",
+      "New Instruments: ['LANDSAT']\n"
      ]
     }
    ],
    "source": [
-    "local_root_2.describe()"
+    "print(f\"New Cloud Cover: {item_to_update.properties['eo:cloud_cover']}\")\n",
+    "print(f\"New Instruments: {item_to_update.properties['instruments']}\")"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "We will write this updated catalog to a temporary directory in our local drive using the [Catalog.normalize_and_save](https://pystac.readthedocs.io/en/latest/api.html#pystac.Catalog.normalize_and_save) method."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 20,
+   "execution_count": 28,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Create a temporary directory\n",
+    "tmp_dir = tempfile.mkdtemp()"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 29,
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Item {}:\n",
-      "  Assets: {'thumbnail': <Asset href=https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/13/0/preview.jpg>}\n",
-      "Item {}:\n",
-      "  Assets: {'thumbnail': <Asset href=https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/15/0/preview.jpg>}\n",
-      "Item {}:\n",
-      "  Assets: {'thumbnail': <Asset href=https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/16/0/preview.jpg>}\n",
-      "Item {}:\n",
-      "  Assets: {'thumbnail': <Asset href=https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/17/0/preview.jpg>}\n",
-      "Item {}:\n",
-      "  Assets: {'thumbnail': <Asset href=https://roda.sentinel-hub.com/sentinel-s2-l1c/tiles/9/V/XK/2017/10/2/0/preview.jpg>}\n"
+      "Catalog saved to: /var/folders/td/xzlhhvqn6gn7_zmrjc0zfb6c0000gn/T/tmpsgh3yx1_/catalog.json\n"
      ]
     }
    ],
    "source": [
-    "for item in local_root_2.get_all_items():\n",
-    "    print('Item {}:')\n",
-    "    print('  Assets: {}'.format(item.assets))"
+    "# Save the catalog and normalize all paths\n",
+    "new_catalog.normalize_and_save(tmp_dir)\n",
+    "print(f\"Catalog saved to: {new_catalog.get_self_href()}\")\n"
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "### Validating\n",
-    "\n",
-    "If we have `jsonschema` installed, either manually or via installing PySTAC with the optional validation dependencies installed:\n",
-    "\n",
-    "```\n",
-    "> pip install pystac[validation]\n",
-    "```\n",
-    "\n",
-    "we can validate our STAC objects to ensure we didn't set any properties that break the spec:"
+    "We can open up Item that we just updated to verify that the new values were written to disk."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 21,
+   "execution_count": 30,
    "metadata": {},
    "outputs": [],
    "source": [
-    "for root, _, items in local_root_2.walk():\n",
-    "    root.validate()\n",
-    "    for item in items:\n",
-    "        item.validate()"
+    "item_path = Path(tmp_dir) / \"landsat-8-l1\" / \"LC80140332018166LGN00\" / \"\""
    ]
   },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "If we have set something wrong, we'll get a `STACValidationException` when we validate:"
+    "Finally, we clean up the temporary directory."
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 22,
+   "execution_count": 31,
    "metadata": {},
-   "outputs": [
-    {
-     "ename": "STACValidationError",
-     "evalue": "Validation failed against schema at https://schemas.stacspec.org/v1.0.0-beta.2/item-spec/json-schema/item.json for STAC ITEM",
-     "output_type": "error",
-     "traceback": [
-      "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
-      "\u001b[0;31mValidationError\u001b[0m                           Traceback (most recent call last)",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/validation/stac_validator.py\u001b[0m in \u001b[0;36mvalidate_core\u001b[0;34m(self, stac_dict, stac_object_type, stac_version)\u001b[0m\n\u001b[1;32m    131\u001b[0m         \u001b[0;32mtry\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 132\u001b[0;31m             \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_validate_from_uri\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mstac_dict\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mschema_uri\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    133\u001b[0m             \u001b[0;32mreturn\u001b[0m \u001b[0mschema_uri\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/validation/stac_validator.py\u001b[0m in \u001b[0;36m_validate_from_uri\u001b[0;34m(self, stac_dict, schema_uri)\u001b[0m\n\u001b[1;32m    105\u001b[0m         \u001b[0mschema\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mresolver\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mget_schema_from_uri\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mschema_uri\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 106\u001b[0;31m         \u001b[0mjsonschema\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalidate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0minstance\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mstac_dict\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mschema\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mschema\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mresolver\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mresolver\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    107\u001b[0m         \u001b[0;32mfor\u001b[0m \u001b[0muri\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mresolver\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mstore\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/jsonschema/validators.py\u001b[0m in \u001b[0;36mvalidate\u001b[0;34m(instance, schema, cls, *args, **kwargs)\u001b[0m\n\u001b[1;32m    933\u001b[0m     \u001b[0;32mif\u001b[0m \u001b[0merror\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 934\u001b[0;31m         \u001b[0;32mraise\u001b[0m \u001b[0merror\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    935\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;31mValidationError\u001b[0m: 'Not a valid bbox' is not of type 'number'\n\nFailed validating 'type' in schema[0]['properties']['bbox']['items']:\n    {'type': 'number'}\n\nOn instance['bbox'][0]:\n    'Not a valid bbox'",
-      "\nThe above exception was the direct cause of the following exception:\n",
-      "\u001b[0;31mSTACValidationError\u001b[0m                       Traceback (most recent call last)",
-      "\u001b[0;32m<ipython-input-22-09a436f4856e>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m      1\u001b[0m \u001b[0mitem\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnext\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mlocal_root_2\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mget_all_items\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m      2\u001b[0m \u001b[0mitem\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mbbox\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0;34m'Not a valid bbox'\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 3\u001b[0;31m \u001b[0mitem\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalidate\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/stac_object.py\u001b[0m in \u001b[0;36mvalidate\u001b[0;34m(self)\u001b[0m\n\u001b[1;32m    232\u001b[0m                                           \u001b[0mstac_object_type\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mSTAC_OBJECT_TYPE\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    233\u001b[0m                                           \u001b[0mstac_version\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mpystac\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mget_stac_version\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 234\u001b[0;31m                                           extensions=self.stac_extensions)\n\u001b[0m\u001b[1;32m    235\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    236\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0mget_root\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/validation/__init__.py\u001b[0m in \u001b[0;36mvalidate\u001b[0;34m(stac_dict, stac_object_type, stac_version, extensions)\u001b[0m\n\u001b[1;32m     71\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     72\u001b[0m     return RegisteredValidator.get_validator().validate(stac_dict, stac_object_type, stac_version,\n\u001b[0;32m---> 73\u001b[0;31m                                                         extensions)\n\u001b[0m\u001b[1;32m     74\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     75\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/validation/stac_validator.py\u001b[0m in \u001b[0;36mvalidate\u001b[0;34m(self, stac_dict, stac_object_type, stac_version, extensions)\u001b[0m\n\u001b[1;32m     64\u001b[0m         \"\"\"\n\u001b[1;32m     65\u001b[0m         \u001b[0mresults\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 66\u001b[0;31m         \u001b[0mcore_result\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mvalidate_core\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mstac_dict\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstac_object_type\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstac_version\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m     67\u001b[0m         \u001b[0;32mif\u001b[0m \u001b[0mcore_result\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     68\u001b[0m             \u001b[0mresults\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mappend\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mcore_result\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/proj/stac/pystac/venv/lib/python3.6/site-packages/pystac-0.5.0rc1-py3.6.egg/pystac/validation/stac_validator.py\u001b[0m in \u001b[0;36mvalidate_core\u001b[0;34m(self, stac_dict, stac_object_type, stac_version)\u001b[0m\n\u001b[1;32m    135\u001b[0m             msg = 'Validation failed against schema at {} for STAC {}'.format(\n\u001b[1;32m    136\u001b[0m                 schema_uri, stac_object_type)\n\u001b[0;32m--> 137\u001b[0;31m             \u001b[0;32mraise\u001b[0m \u001b[0mSTACValidationError\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mmsg\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0msource\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0me\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mfrom\u001b[0m \u001b[0me\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    138\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    139\u001b[0m     \u001b[0;32mdef\u001b[0m \u001b[0mvalidate_extension\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstac_dict\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstac_object_type\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstac_version\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mextension_id\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;31mSTACValidationError\u001b[0m: Validation failed against schema at https://schemas.stacspec.org/v1.0.0-beta.2/item-spec/json-schema/item.json for STAC ITEM"
-     ]
-    }
-   ],
+   "outputs": [],
    "source": [
-    "item = next(local_root_2.get_all_items())\n",
-    "item.bbox = ['Not a valid bbox']\n",
-    "item.validate()"
+    "shutil.rmtree(tmp_dir, ignore_errors=True)"
    ]
   },
   {
@@ -633,7 +812,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -647,7 +826,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.5"
+   "version": "3.8.9"
   }
  },
  "nbformat": 4,
diff --git a/docs/tutorials.rst b/docs/tutorials.rst
index ec5e88837..6c1dc5d74 100644
--- a/docs/tutorials.rst
+++ b/docs/tutorials.rst
@@ -7,7 +7,7 @@ PySTAC Introduction
 -------------------
 
 - :tutorial:`GitHub version <pystac-introduction.ipynb>`
-- :ref:`Docs version </tutorials/pystac-spacenet-tutorial.ipynb>`
+- :ref:`Docs version </tutorials/pystac-introduction.ipynb>`
 
 This tutorial gives an introduction to PySTAC concepts through code examples.
 
@@ -49,3 +49,10 @@ Adding New and Custom Extensions
 
 This tutorial goes over how to contribute new extensions to PySTAC as well as how to
 implement your own custom extensions.
+
+.. toctree::
+    :hidden:
+    :maxdepth: 2
+    :glob:
+
+    tutorials/**
diff --git a/docs/tutorials/creating-a-landsat-stac.ipynb b/docs/tutorials/creating-a-landsat-stac.ipynb
index db98581c3..478908d78 100644
--- a/docs/tutorials/creating-a-landsat-stac.ipynb
+++ b/docs/tutorials/creating-a-landsat-stac.ipynb
@@ -25,7 +25,13 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "import pystac"
+    "from typing import Any, Dict, List, Optional, cast\n",
+    "from typing_extensions import TypedDict\n",
+    "\n",
+    "import pystac\n",
+    "from pystac.extensions.eo import EOExtension\n",
+    "from pystac.extensions.projection import ProjectionExtension\n",
+    "from pystac.extensions.view import ViewExtension"
    ]
   },
   {
@@ -44,10 +50,28 @@
    "outputs": [],
    "source": [
     "import csv\n",
+    "from datetime import datetime\n",
     "import gzip\n",
     "from io import StringIO\n",
     "from urllib.request import urlopen\n",
     "\n",
+    "# Here we use a TypedDict to define the structure of the Landsat scene dictionaries\n",
+    "# we will be working with. You can read more about the TypedDict class here:\n",
+    "# https://docs.python.org/3/library/typing.html#typing.TypedDict\n",
+    "class Scene(TypedDict):\n",
+    "    productId: str\n",
+    "    entityId: str\n",
+    "    acquisitionDate: str\n",
+    "    cloudCover: str\n",
+    "    processingLevel: str\n",
+    "    path: str\n",
+    "    row: str\n",
+    "    min_lat: str\n",
+    "    min_lon: str\n",
+    "    max_lat: str\n",
+    "    max_lon: str\n",
+    "    download_url: str\n",
+    "\n",
     "# Collection 1 data\n",
     "url = 'https://landsat-pds.s3.amazonaws.com/c1/L8/scene_list.gz'\n",
     "\n",
@@ -57,7 +81,7 @@
     "content = gunzip_response.read()\n",
     "\n",
     "# Read the scenes in as dictionaries\n",
-    "scenes = list(csv.DictReader(StringIO(content.decode(\"utf-8\"))))"
+    "scenes: List[Scene] = list(map(lambda s: cast(Scene, s), csv.DictReader(StringIO(content.decode(\"utf-8\")))))"
    ]
   },
   {
@@ -68,7 +92,7 @@
     {
      "data": {
       "text/plain": [
-       "2073901"
+       "2390885"
       ]
      },
      "execution_count": 3,
@@ -97,19 +121,18 @@
     {
      "data": {
       "text/plain": [
-       "OrderedDict([('productId', 'LC08_L1TP_149039_20170411_20170415_01_T1'),\n",
-       "             ('entityId', 'LC81490392017101LGN00'),\n",
-       "             ('acquisitionDate', '2017-04-11 05:36:29.349932'),\n",
-       "             ('cloudCover', '0.0'),\n",
-       "             ('processingLevel', 'L1TP'),\n",
-       "             ('path', '149'),\n",
-       "             ('row', '39'),\n",
-       "             ('min_lat', '29.22165'),\n",
-       "             ('min_lon', '72.41205'),\n",
-       "             ('max_lat', '31.34742'),\n",
-       "             ('max_lon', '74.84666'),\n",
-       "             ('download_url',\n",
-       "              'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/149/039/LC08_L1TP_149039_20170411_20170415_01_T1/index.html')])"
+       "{'productId': 'LC08_L1TP_149039_20170411_20170415_01_T1',\n",
+       " 'entityId': 'LC81490392017101LGN00',\n",
+       " 'acquisitionDate': '2017-04-11 05:36:29.349932',\n",
+       " 'cloudCover': '0.0',\n",
+       " 'processingLevel': 'L1TP',\n",
+       " 'path': '149',\n",
+       " 'row': '39',\n",
+       " 'min_lat': '29.22165',\n",
+       " 'min_lon': '72.41205',\n",
+       " 'max_lat': '31.34742',\n",
+       " 'max_lon': '74.84666',\n",
+       " 'download_url': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/149/039/LC08_L1TP_149039_20170411_20170415_01_T1/index.html'}"
       ]
      },
      "execution_count": 4,
@@ -161,7 +184,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def keep_scene(scene):\n",
+    "def keep_scene(scene: Scene) -> bool:\n",
     "    contains_location = float(scene['min_lat']) < lat and float(scene['max_lat']) > lat and \\\n",
     "                        float(scene['min_lon']) < lon and float(scene['max_lon']) > lon\n",
     "    is_correct_year = '{}-'.format(filter_year) in scene['acquisitionDate']\n",
@@ -185,7 +208,7 @@
     {
      "data": {
       "text/plain": [
-       "52"
+       "77"
       ]
      },
      "execution_count": 7,
@@ -212,19 +235,18 @@
     {
      "data": {
       "text/plain": [
-       "OrderedDict([('productId', 'LC08_L1GT_015032_20200103_20200103_01_RT'),\n",
-       "             ('entityId', 'LC80150322020003LGN00'),\n",
-       "             ('acquisitionDate', '2020-01-03 15:46:15.625235'),\n",
-       "             ('cloudCover', '100.0'),\n",
-       "             ('processingLevel', 'L1GT'),\n",
-       "             ('path', '15'),\n",
-       "             ('row', '32'),\n",
-       "             ('min_lat', '39.23189'),\n",
-       "             ('min_lon', '-77.83282'),\n",
-       "             ('max_lat', '41.37536'),\n",
-       "             ('max_lon', '-75.02666'),\n",
-       "             ('download_url',\n",
-       "              'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1GT_015032_20200103_20200103_01_RT/index.html')])"
+       "{'productId': 'LC08_L1GT_015032_20200103_20200103_01_RT',\n",
+       " 'entityId': 'LC80150322020003LGN00',\n",
+       " 'acquisitionDate': '2020-01-03 15:46:15.625235',\n",
+       " 'cloudCover': '100.0',\n",
+       " 'processingLevel': 'L1GT',\n",
+       " 'path': '15',\n",
+       " 'row': '32',\n",
+       " 'min_lat': '39.23189',\n",
+       " 'min_lon': '-77.83282',\n",
+       " 'max_lat': '41.37536',\n",
+       " 'max_lon': '-75.02666',\n",
+       " 'download_url': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1GT_015032_20200103_20200103_01_RT/index.html'}"
       ]
      },
      "execution_count": 8,
@@ -254,7 +276,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_asset_url(scene, suffix):\n",
+    "def get_asset_url(scene: Scene, suffix: str) -> str:\n",
     "    product_id = scene['productId']\n",
     "    download_url = scene['download_url']    \n",
     "    asset_filename = '{}_{}'.format(product_id, suffix)\n",
@@ -500,8 +522,9 @@
     }
    ],
    "source": [
+    "stac_io = pystac.StacIO.default()\n",
     "mtl_url = get_asset_url(scene, 'MTL.txt')\n",
-    "print(pystac.STAC_IO.read_text(mtl_url))"
+    "print(stac_io.read_text(mtl_url))"
    ]
   },
   {
@@ -517,10 +540,10 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_metadata(url):\n",
+    "def get_metadata(url: str) -> Dict[str, Any]:\n",
     "    \"\"\" Convert Landsat MTL file to dictionary of metadata values \"\"\"\n",
     "    mtl = {}\n",
-    "    mtl_text = pystac.STAC_IO.read_text(url)\n",
+    "    mtl_text = stac_io.read_text(url)\n",
     "    for line in mtl_text.split('\\n'):\n",
     "        meta = line.replace('\\\"', \"\").strip().split('=')\n",
     "        if len(meta) > 1:\n",
@@ -770,7 +793,7 @@
      "text": [
       "Help on function __init__ in module pystac.item:\n",
       "\n",
-      "__init__(self, id, geometry, bbox, datetime, properties, stac_extensions=None, href=None, collection=None, extra_fields=None)\n",
+      "__init__(self, id: str, geometry: Union[Dict[str, Any], NoneType], bbox: Union[List[float], NoneType], datetime: Union[datetime.datetime, NoneType], properties: Dict[str, Any], stac_extensions: Union[List[str], NoneType] = None, href: Union[str, NoneType] = None, collection: Union[str, pystac.collection.Collection, NoneType] = None, extra_fields: Union[Dict[str, Any], NoneType] = None)\n",
       "    Initialize self.  See help(type(self)) for accurate signature.\n",
       "\n"
      ]
@@ -802,8 +825,8 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_item_id(metadata):\n",
-    "    return metadata['LANDSAT_SCENE_ID'][:-5]"
+    "def get_item_id(metadata: Dict[str, Any]) -> str:\n",
+    "    return cast(str, metadata['LANDSAT_SCENE_ID'][:-5])"
    ]
   },
   {
@@ -844,7 +867,7 @@
    "source": [
     "from dateutil.parser import parse\n",
     "\n",
-    "def get_datetime(metadata):\n",
+    "def get_datetime(metadata: Dict[str, Any]) -> datetime:\n",
     "    return parse('%sT%s' % (metadata['DATE_ACQUIRED'], metadata['SCENE_CENTER_TIME']))"
    ]
   },
@@ -884,7 +907,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_bbox(metadata):\n",
+    "def get_bbox(metadata: Dict[str, Any]) -> List[float]:\n",
     "    coords = [[\n",
     "        [float(metadata['CORNER_UL_LON_PRODUCT']), float(metadata['CORNER_UL_LAT_PRODUCT'])],\n",
     "        [float(metadata['CORNER_UR_LON_PRODUCT']), float(metadata['CORNER_UR_LAT_PRODUCT'])],\n",
@@ -935,11 +958,11 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_geometry(scene, bbox):\n",
+    "def get_geometry(scene: Scene, bbox: List[float]) -> Dict[str, Any]:\n",
     "    url = get_asset_url(scene, 'ANG.txt')\n",
     "    sz = []\n",
     "    coords = []\n",
-    "    ang_text = pystac.STAC_IO.read_text(url)\n",
+    "    ang_text = stac_io.read_text(url)\n",
     "    for line in ang_text.split('\\n'):\n",
     "        if 'BAND01_NUM_L1T_LINES' in line or 'BAND01_NUM_L1T_SAMPS' in line:\n",
     "            sz.append(float(line.split('=')[1]))\n",
@@ -1069,7 +1092,18 @@
    "cell_type": "code",
    "execution_count": 24,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "['https://schemas.stacspec.org/v1.0.0/item-spec/json-schema/item.json']"
+      ]
+     },
+     "execution_count": 24,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "item.validate()"
    ]
@@ -1109,7 +1143,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "item.ext.enable('eo')"
+    "eo_ext = EOExtension.ext(item, add_if_missing=True)"
    ]
   },
   {
@@ -1127,7 +1161,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_cloud_cover(metadata):\n",
+    "def get_cloud_cover(metadata: Dict[str, Any]) -> float:\n",
     "    return float(metadata['CLOUD_COVER'])"
    ]
   },
@@ -1148,8 +1182,8 @@
     }
    ],
    "source": [
-    "item.ext.eo.cloud_cover = get_cloud_cover(metadata)\n",
-    "item.ext.eo.cloud_cover"
+    "eo_ext.cloud_cover = get_cloud_cover(metadata)\n",
+    "eo_ext.cloud_cover"
    ]
   },
   {
@@ -1171,7 +1205,12 @@
    "source": [
     "from pystac.extensions.eo import Band\n",
     "\n",
-    "landsat_band_info = {\n",
+    "class BandInfo(TypedDict):\n",
+    "    band: Band\n",
+    "    gsd: float\n",
+    "\n",
+    "\n",
+    "landsat_band_info: Dict[str, BandInfo] = {\n",
     "    'B1': {\n",
     "        'band': Band.create(name=\"B1\", common_name=\"coastal\", center_wavelength=0.48, full_width_half_max=0.02),\n",
     "        'gsd': 30.0\n",
@@ -1232,7 +1271,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_other_assets(scene):\n",
+    "def get_other_assets(scene: Scene) -> Dict[str, Dict[str, Any]]:\n",
     "    return {\n",
     "    'thumbnail': {\n",
     "        'href': get_asset_url(scene, 'thumb_large.jpg'),\n",
@@ -1270,18 +1309,19 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def add_assets(item, scene):\n",
+    "def add_assets(item: pystac.Item, scene: Scene) -> None:\n",
     "    # Add bands\n",
     "    for band_id, band_info in landsat_band_info.items():\n",
     "        band_url = get_asset_url(scene, '{}.TIF'.format(band_id))\n",
     "        asset = pystac.Asset(href=band_url, media_type=pystac.MediaType.COG)\n",
     "        bands = [band_info['band']]\n",
-    "        item.ext.eo.set_bands(bands, asset)\n",
+    "        asset_eo_ext = EOExtension.ext(asset)\n",
+    "        asset_eo_ext.bands = bands\n",
     "        item.add_asset(band_id, asset)\n",
     "        \n",
     "        # If this asset has a different GSD than the item, set it on the asset\n",
     "        if band_info['gsd'] != item.common_metadata.gsd:\n",
-    "            item.common_metadata.set_gsd(band_info['gsd'], asset)\n",
+    "            asset.common_metadata.gsd = band_info[\"gsd\"]\n",
     "        \n",
     "    # Add other assets\n",
     "    for asset_id, asset_info in get_other_assets(scene).items():\n",
@@ -1315,7 +1355,7 @@
      "data": {
       "text/plain": [
        "{'href': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1GT_015032_20200103_20200103_01_RT/LC08_L1GT_015032_20200103_20200103_01_RT_B10.TIF',\n",
-       " 'type': 'image/tiff; application=geotiff; profile=cloud-optimized',\n",
+       " 'type': <MediaType.COG: 'image/tiff; application=geotiff; profile=cloud-optimized'>,\n",
        " 'eo:bands': [{'name': 'B10',\n",
        "   'common_name': 'lwir11',\n",
        "   'center_wavelength': 10.9,\n",
@@ -1341,7 +1381,7 @@
      "data": {
       "text/plain": [
        "{'href': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1GT_015032_20200103_20200103_01_RT/LC08_L1GT_015032_20200103_20200103_01_RT_B3.TIF',\n",
-       " 'type': 'image/tiff; application=geotiff; profile=cloud-optimized',\n",
+       " 'type': <MediaType.COG: 'image/tiff; application=geotiff; profile=cloud-optimized'>,\n",
        " 'eo:bands': [{'name': 'B3',\n",
        "   'common_name': 'green',\n",
        "   'center_wavelength': 0.56,\n",
@@ -1373,7 +1413,7 @@
      "data": {
       "text/plain": [
        "{'href': 'https://s3-us-west-2.amazonaws.com/landsat-pds/c1/L8/015/032/LC08_L1GT_015032_20200103_20200103_01_RT/LC08_L1GT_015032_20200103_20200103_01_RT_thumb_large.jpg',\n",
-       " 'type': 'image/jpeg'}"
+       " 'type': <MediaType.JPEG: 'image/jpeg'>}"
       ]
      },
      "execution_count": 35,
@@ -1400,7 +1440,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_epsg(metadata, min_lat, max_lat):\n",
+    "def get_epsg(metadata: Dict[str, Any], min_lat: float, max_lat: float) -> Optional[int]:\n",
     "    if 'UTM_ZONE' in metadata:\n",
     "        center_lat = (min_lat + max_lat)/2.0\n",
     "        return int(('326' if center_lat > 0 else '327') + metadata['UTM_ZONE'])\n",
@@ -1410,24 +1450,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 37,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "32618"
-      ]
-     },
-     "execution_count": 37,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
-    "item.ext.enable('projection')\n",
-    "item.ext.projection.epsg = get_epsg(metadata, item.bbox[1], item.bbox[3]) \n",
-    "item.ext.projection.epsg"
+    "proj_ext = ProjectionExtension.ext(item, add_if_missing=True)\n",
+    "assert item.bbox is not None\n",
+    "proj_ext.epsg = get_epsg(metadata, item.bbox[1], item.bbox[3]) \n",
+    "proj_ext.epsg"
    ]
   },
   {
@@ -1441,18 +1471,18 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 38,
+   "execution_count": 37,
    "metadata": {},
    "outputs": [],
    "source": [
-    "def get_view_info(metadata):\n",
+    "def get_view_info(metadata: Dict[str, Any]) -> Dict[str, float]:\n",
     "    return { 'sun_azimuth': float(metadata['SUN_AZIMUTH']),\n",
     "             'sun_elevation': float(metadata['SUN_ELEVATION']) }"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 39,
+   "execution_count": 38,
    "metadata": {},
    "outputs": [
     {
@@ -1461,21 +1491,20 @@
        "{'datetime': '2020-01-03T15:46:15.625235Z',\n",
        " 'gsd': 30.0,\n",
        " 'eo:cloud_cover': 100.0,\n",
-       " 'proj:epsg': 32618,\n",
        " 'view:sun_azimuth': 158.89720783,\n",
        " 'view:sun_elevation': 23.89789093}"
       ]
      },
-     "execution_count": 39,
+     "execution_count": 38,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "item.ext.enable('view')\n",
+    "view_ext = ViewExtension.ext(item, add_if_missing=True)\n",
     "view_info = get_view_info(metadata)\n",
-    "item.ext.view.sun_azimuth = view_info['sun_azimuth']\n",
-    "item.ext.view.sun_elevation = view_info['sun_elevation']\n",
+    "view_ext.sun_azimuth = view_info['sun_azimuth']\n",
+    "view_ext.sun_elevation = view_info['sun_elevation']\n",
     "item.properties"
    ]
   },
@@ -1488,9 +1517,22 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 40,
+   "execution_count": 39,
    "metadata": {},
-   "outputs": [],
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "['https://schemas.stacspec.org/v1.0.0/item-spec/json-schema/item.json',\n",
+       " 'https://stac-extensions.github.io/eo/v1.0.0/schema.json',\n",
+       " 'https://stac-extensions.github.io/view/v1.0.0/schema.json']"
+      ]
+     },
+     "execution_count": 39,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "item.validate()"
    ]
@@ -1508,7 +1550,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 41,
+   "execution_count": 40,
    "metadata": {},
    "outputs": [
     {
@@ -1517,7 +1559,7 @@
      "text": [
       "Help on function __init__ in module pystac.collection:\n",
       "\n",
-      "__init__(self, id, description, extent, title=None, stac_extensions=None, href=None, extra_fields=None, license='proprietary', keywords=None, providers=None, properties=None, summaries=None)\n",
+      "__init__(self, id: str, description: str, extent: pystac.collection.Extent, title: Union[str, NoneType] = None, stac_extensions: Union[List[str], NoneType] = None, href: Union[str, NoneType] = None, extra_fields: Union[Dict[str, Any], NoneType] = None, catalog_type: Union[pystac.catalog.CatalogType, NoneType] = None, license: str = 'proprietary', keywords: Union[List[str], NoneType] = None, providers: Union[List[ForwardRef('Provider_Type')], NoneType] = None, summaries: Union[pystac.summaries.Summaries, NoneType] = None)\n",
       "    Initialize self.  See help(type(self)) for accurate signature.\n",
       "\n"
      ]
@@ -1538,7 +1580,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 42,
+   "execution_count": 41,
    "metadata": {},
    "outputs": [
     {
@@ -1547,7 +1589,7 @@
        "'Philly-landsat-8'"
       ]
      },
-     "execution_count": 42,
+     "execution_count": 41,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1568,7 +1610,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 43,
+   "execution_count": 42,
    "metadata": {},
    "outputs": [
     {
@@ -1577,7 +1619,7 @@
        "'2020 Landsat 8 images over Philly'"
       ]
      },
-     "execution_count": 43,
+     "execution_count": 42,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1600,7 +1642,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 44,
+   "execution_count": 43,
    "metadata": {},
    "outputs": [
     {
@@ -1635,20 +1677,20 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 45,
+   "execution_count": 44,
    "metadata": {},
    "outputs": [],
    "source": [
     "from datetime import datetime\n",
     "\n",
-    "spatial_extent = pystac.SpatialExtent([[-180, -90, 180, 90]])\n",
+    "spatial_extent = pystac.SpatialExtent([[-180., -90., 180., 90.]])\n",
     "temporal_extent = pystac.TemporalExtent([[datetime(2013, 6, 1), None]])\n",
     "collection_extent = pystac.Extent(spatial_extent, temporal_extent)"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 46,
+   "execution_count": 45,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1667,23 +1709,28 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 47,
+   "execution_count": 46,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{'id': 'Philly-landsat-8',\n",
-       " 'stac_version': '1.0.0-beta.2',\n",
+       "{'type': 'Collection',\n",
+       " 'id': 'Philly-landsat-8',\n",
+       " 'stac_version': '1.0.0',\n",
        " 'description': '### Philly Landsat 8\\n\\nA collection of Landsat 8 scenes around Philly in 2020.\\n',\n",
-       " 'links': [{'rel': 'root', 'href': None, 'type': 'application/json'}],\n",
+       " 'links': [{'rel': <RelType.ROOT: 'root'>,\n",
+       "   'href': None,\n",
+       "   'type': <MediaType.JSON: 'application/json'>,\n",
+       "   'title': '2020 Landsat 8 images over Philly'}],\n",
+       " 'stac_extensions': [],\n",
        " 'title': '2020 Landsat 8 images over Philly',\n",
        " 'extent': {'spatial': {'bbox': [[-180, -90, 180, 90]]},\n",
        "  'temporal': {'interval': [['2013-06-01T00:00:00Z', None]]}},\n",
        " 'license': 'proprietary'}"
       ]
      },
-     "execution_count": 47,
+     "execution_count": 46,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1703,7 +1750,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 48,
+   "execution_count": 47,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1721,14 +1768,14 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 49,
+   "execution_count": 48,
    "metadata": {},
    "outputs": [],
    "source": [
     "collection.providers = [\n",
-    "    pystac.Provider(name='USGS', roles=['producer'], url='https://landsat.usgs.gov/'),\n",
-    "    pystac.Provider(name='Planet Labs', roles=['processor'], url='https://github.com/landsat-pds/landsat_ingestor'),\n",
-    "    pystac.Provider(name='AWS', roles=['host'], url='https://landsatonaws.com/')\n",
+    "    pystac.Provider(name='USGS', roles=[pystac.ProviderRole.PRODUCER], url='https://landsat.usgs.gov/'),\n",
+    "    pystac.Provider(name='Planet Labs', roles=[pystac.ProviderRole.PROCESSOR], url='https://github.com/landsat-pds/landsat_ingestor'),\n",
+    "    pystac.Provider(name='AWS', roles=[pystac.ProviderRole.HOST], url='https://landsatonaws.com/')\n",
     "]"
    ]
   },
@@ -1743,11 +1790,11 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 50,
+   "execution_count": 49,
    "metadata": {},
    "outputs": [],
    "source": [
-    "def item_from_scene(scene):\n",
+    "def item_from_scene(scene: Scene) -> pystac.Item:\n",
     "    mtl_url = get_asset_url(scene, 'MTL.txt')\n",
     "    metadata = get_metadata(mtl_url)\n",
     "    \n",
@@ -1760,18 +1807,19 @@
     "    \n",
     "    item.common_metadata.gsd = 30.0\n",
     "    \n",
-    "    item.ext.enable('eo')\n",
-    "    item.ext.eo.cloud_cover = get_cloud_cover(metadata)\n",
+    "    item_eo_ext = EOExtension.ext(item, add_if_missing=True)\n",
+    "    item_eo_ext.cloud_cover = get_cloud_cover(metadata)\n",
     "    \n",
     "    add_assets(item, scene)\n",
     "    \n",
-    "    item.ext.enable('projection')\n",
-    "    item.ext.projection.epsg = get_epsg(metadata, item.bbox[1], item.bbox[3]) \n",
+    "    item_proj_ext = ProjectionExtension.ext(item, add_if_missing=True)\n",
+    "    assert item.bbox is not None\n",
+    "    item_proj_ext.epsg = get_epsg(metadata, item.bbox[1], item.bbox[3]) \n",
     "\n",
-    "    item.ext.enable('view')\n",
+    "    item_view_ext = ViewExtension.ext(item, add_if_missing=True)\n",
     "    view_info = get_view_info(metadata)\n",
-    "    item.ext.view.sun_azimuth = view_info['sun_azimuth']\n",
-    "    item.ext.view.sun_elevation = view_info['sun_elevation']\n",
+    "    item_view_ext.sun_azimuth = view_info['sun_azimuth']\n",
+    "    item_view_ext.sun_elevation = view_info['sun_elevation']\n",
     "\n",
     "    item.validate()\n",
     "    \n",
@@ -1788,7 +1836,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 51,
+   "execution_count": 50,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1808,7 +1856,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 52,
+   "execution_count": 51,
    "metadata": {},
    "outputs": [
     {
@@ -1816,10 +1864,10 @@
       "text/plain": [
        "{'spatial': {'bbox': [[-77.88298, 39.23073, -73.46322, 41.41025]]},\n",
        " 'temporal': {'interval': [['2020-01-03T15:46:15.625235Z',\n",
-       "    '2020-08-30T15:46:11.765407Z']]}}"
+       "    '2020-12-29T15:40:09.950514Z']]}}"
       ]
      },
-     "execution_count": 52,
+     "execution_count": 51,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -1844,20 +1892,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 53,
+   "execution_count": 52,
    "metadata": {},
-   "outputs": [
-    {
-     "data": {
-      "text/plain": [
-       "<Collection id=Philly-landsat-8>"
-      ]
-     },
-     "execution_count": 53,
-     "metadata": {},
-     "output_type": "execute_result"
-    }
-   ],
+   "outputs": [],
    "source": [
     "from pathlib import Path\n",
     "\n",
@@ -1875,7 +1912,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 54,
+   "execution_count": 53,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1895,7 +1932,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 55,
+   "execution_count": 54,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -1911,7 +1948,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 56,
+   "execution_count": 55,
    "metadata": {},
    "outputs": [
     {
@@ -1970,7 +2007,32 @@
       "  * <Item id=LC80140322020204>\n",
       "  * <Item id=LC80150322020227>\n",
       "  * <Item id=LC80140322020220>\n",
-      "  * <Item id=LC80150322020243>\n"
+      "  * <Item id=LC80150322020243>\n",
+      "  * <Item id=LC80140322020236>\n",
+      "  * <Item id=LC80140322020252>\n",
+      "  * <Item id=LC80150322020243>\n",
+      "  * <Item id=LC80150322020243>\n",
+      "  * <Item id=LC80140322020236>\n",
+      "  * <Item id=LC80150322020259>\n",
+      "  * <Item id=LC80150322020259>\n",
+      "  * <Item id=LC80140322020252>\n",
+      "  * <Item id=LC80140322020268>\n",
+      "  * <Item id=LC80150322020275>\n",
+      "  * <Item id=LC80150322020275>\n",
+      "  * <Item id=LC80140322020268>\n",
+      "  * <Item id=LC80140322020284>\n",
+      "  * <Item id=LC80140322020284>\n",
+      "  * <Item id=LC80150322020291>\n",
+      "  * <Item id=LC80140322020300>\n",
+      "  * <Item id=LC80140322020332>\n",
+      "  * <Item id=LC80150322020339>\n",
+      "  * <Item id=LC80150322020323>\n",
+      "  * <Item id=LC80140322020332>\n",
+      "  * <Item id=LC80140322020348>\n",
+      "  * <Item id=LC80150322020339>\n",
+      "  * <Item id=LC80140322020348>\n",
+      "  * <Item id=LC80150322020355>\n",
+      "  * <Item id=LC80140322020364>\n"
      ]
     }
    ],
@@ -1987,181 +2049,259 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 57,
+   "execution_count": 56,
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{'id': 'Philly-landsat-8',\n",
-       " 'stac_version': '1.0.0-beta.2',\n",
+       "{'type': 'Collection',\n",
+       " 'id': 'Philly-landsat-8',\n",
+       " 'stac_version': '1.0.0',\n",
        " 'description': '### Philly Landsat 8\\n\\nA collection of Landsat 8 scenes around Philly in 2020.\\n',\n",
-       " 'links': [{'rel': 'root',\n",
+       " 'links': [{'rel': <RelType.ROOT: 'root'>,\n",
        "   'href': './collection.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>,\n",
+       "   'title': '2020 Landsat 8 images over Philly'},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020003/LC80150322020003.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020012/LC80140322020012.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020019/LC80150322020019.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020012/LC80140322020012.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020019/LC80150322020019.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020028/LC80140322020028.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020035/LC80150322020035.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020028/LC80140322020028.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020044/LC80140322020044.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020051/LC80150322020051.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020051/LC80150322020051.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020051/LC80150322020051.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020051/LC80150322020051.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020060/LC80140322020060.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020067/LC80150322020067.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020060/LC80140322020060.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020067/LC80150322020067.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020076/LC80140322020076.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020083/LC80150322020083.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020076/LC80140322020076.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020092/LC80140322020092.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020099/LC80150322020099.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020092/LC80140322020092.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020108/LC80140322020108.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020108/LC80140322020108.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020115/LC80150322020115.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020099/LC80150322020099.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020124/LC80140322020124.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020131/LC80150322020131.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020124/LC80140322020124.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020140/LC80140322020140.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020147/LC80150322020147.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020131/LC80150322020131.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020140/LC80140322020140.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020156/LC80140322020156.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020147/LC80150322020147.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020156/LC80140322020156.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020163/LC80150322020163.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020172/LC80140322020172.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020179/LC80150322020179.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020163/LC80150322020163.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020188/LC80140322020188.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020172/LC80140322020172.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020179/LC80150322020179.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020195/LC80150322020195.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020211/LC80150322020211.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020195/LC80150322020195.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020188/LC80140322020188.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020204/LC80140322020204.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020227/LC80150322020227.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80140322020220/LC80140322020220.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'item',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
        "   'href': './LC80150322020243/LC80150322020243.json',\n",
-       "   'type': 'application/json'},\n",
-       "  {'rel': 'self',\n",
-       "   'href': '/Users/rob/Philly-landsat-stac/collection.json',\n",
-       "   'type': 'application/json'}],\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020236/LC80140322020236.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020252/LC80140322020252.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020243/LC80150322020243.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020243/LC80150322020243.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020236/LC80140322020236.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020259/LC80150322020259.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020259/LC80150322020259.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020252/LC80140322020252.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020268/LC80140322020268.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020275/LC80150322020275.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020275/LC80150322020275.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020268/LC80140322020268.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020284/LC80140322020284.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020284/LC80140322020284.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020291/LC80150322020291.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020300/LC80140322020300.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020332/LC80140322020332.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020339/LC80150322020339.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020323/LC80150322020323.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020332/LC80140322020332.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020348/LC80140322020348.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020339/LC80150322020339.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020348/LC80140322020348.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80150322020355/LC80150322020355.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.ITEM: 'item'>,\n",
+       "   'href': './LC80140322020364/LC80140322020364.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>},\n",
+       "  {'rel': <RelType.SELF: 'self'>,\n",
+       "   'href': '/Users/jduckworth/Philly-landsat-stac/collection.json',\n",
+       "   'type': <MediaType.JSON: 'application/json'>}],\n",
+       " 'stac_extensions': [],\n",
        " 'title': '2020 Landsat 8 images over Philly',\n",
        " 'extent': {'spatial': {'bbox': [[-77.88298, 39.23073, -73.46322, 41.41025]]},\n",
        "  'temporal': {'interval': [['2020-01-03T15:46:15.625235Z',\n",
-       "     '2020-08-30T15:46:11.765407Z']]}},\n",
+       "     '2020-12-29T15:40:09.950514Z']]}},\n",
        " 'license': 'proprietary',\n",
        " 'providers': [{'name': 'USGS',\n",
        "   'roles': ['producer'],\n",
@@ -2172,7 +2312,7 @@
        "  {'name': 'AWS', 'roles': ['host'], 'url': 'https://landsatonaws.com/'}]}"
       ]
      },
-     "execution_count": 57,
+     "execution_count": 56,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -2192,7 +2332,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 58,
+   "execution_count": 57,
    "metadata": {},
    "outputs": [
     {
@@ -2202,9 +2342,9 @@
      "traceback": [
       "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m",
       "\u001b[0;31mKeyboardInterrupt\u001b[0m                         Traceback (most recent call last)",
-      "\u001b[0;32m<ipython-input-58-3e032debc920>\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m     13\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     14\u001b[0m \u001b[0;32mwith\u001b[0m \u001b[0mHTTPServer\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m'localhost'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;36m5555\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mCORSRequestHandler\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mhttpd\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 15\u001b[0;31m     \u001b[0mhttpd\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mserve_forever\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
-      "\u001b[0;32m~/anaconda/lib/python3.6/socketserver.py\u001b[0m in \u001b[0;36mserve_forever\u001b[0;34m(self, poll_interval)\u001b[0m\n\u001b[1;32m    234\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    235\u001b[0m                 \u001b[0;32mwhile\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__shutdown_request\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 236\u001b[0;31m                     \u001b[0mready\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mselector\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mselect\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mpoll_interval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    237\u001b[0m                     \u001b[0;32mif\u001b[0m \u001b[0mready\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    238\u001b[0m                         \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_handle_request_noblock\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
-      "\u001b[0;32m~/anaconda/lib/python3.6/selectors.py\u001b[0m in \u001b[0;36mselect\u001b[0;34m(self, timeout)\u001b[0m\n\u001b[1;32m    374\u001b[0m             \u001b[0mready\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    375\u001b[0m             \u001b[0;32mtry\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 376\u001b[0;31m                 \u001b[0mfd_event_list\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_poll\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mpoll\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mtimeout\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    377\u001b[0m             \u001b[0;32mexcept\u001b[0m \u001b[0mInterruptedError\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    378\u001b[0m                 \u001b[0;32mreturn\u001b[0m \u001b[0mready\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
+      "\u001b[0;32m/var/folders/td/xzlhhvqn6gn7_zmrjc0zfb6c0000gn/T/ipykernel_13162/2713200350.py\u001b[0m in \u001b[0;36m<module>\u001b[0;34m\u001b[0m\n\u001b[1;32m     13\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m     14\u001b[0m \u001b[0;32mwith\u001b[0m \u001b[0mHTTPServer\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m'localhost'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;36m5555\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mCORSRequestHandler\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mhttpd\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 15\u001b[0;31m     \u001b[0mhttpd\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mserve_forever\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m",
+      "\u001b[0;32m~/.pyenv/versions/3.8.9/lib/python3.8/socketserver.py\u001b[0m in \u001b[0;36mserve_forever\u001b[0;34m(self, poll_interval)\u001b[0m\n\u001b[1;32m    230\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    231\u001b[0m                 \u001b[0;32mwhile\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__shutdown_request\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 232\u001b[0;31m                     \u001b[0mready\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mselector\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mselect\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mpoll_interval\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    233\u001b[0m                     \u001b[0;31m# bpo-35017: shutdown() called during select(), exit immediately.\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    234\u001b[0m                     \u001b[0;32mif\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m__shutdown_request\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
+      "\u001b[0;32m~/.pyenv/versions/3.8.9/lib/python3.8/selectors.py\u001b[0m in \u001b[0;36mselect\u001b[0;34m(self, timeout)\u001b[0m\n\u001b[1;32m    413\u001b[0m         \u001b[0mready\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    414\u001b[0m         \u001b[0;32mtry\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m--> 415\u001b[0;31m             \u001b[0mfd_event_list\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mself\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_selector\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mpoll\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mtimeout\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m    416\u001b[0m         \u001b[0;32mexcept\u001b[0m \u001b[0mInterruptedError\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m    417\u001b[0m             \u001b[0;32mreturn\u001b[0m \u001b[0mready\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n",
       "\u001b[0;31mKeyboardInterrupt\u001b[0m: "
      ]
     }
@@ -2216,7 +2356,7 @@
     "os.chdir(root_path)\n",
     "\n",
     "class CORSRequestHandler(SimpleHTTPRequestHandler):\n",
-    "    def end_headers(self):\n",
+    "    def end_headers(self) -> None:\n",
     "        self.send_header('Access-Control-Allow-Origin', '*')\n",
     "        self.send_header('Access-Control-Allow-Methods', 'GET')\n",
     "        self.send_header('Cache-Control', 'no-store, no-cache, must-revalidate')\n",
@@ -2262,7 +2402,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.5"
+   "version": "3.8.9"
   }
  },
  "nbformat": 4,
diff --git a/pystac/cache.py b/pystac/cache.py
index f33863fed..2b6b9917b 100644
--- a/pystac/cache.py
+++ b/pystac/cache.py
@@ -59,6 +59,18 @@ class ResolvedObjectCache:
             to collections.
     """
 
+    id_keys_to_objects: Dict[str, "STACObject_Type"]
+    """Existing cache of a key made up of the STACObject and it's parents IDs mapped
+    to the cached STACObject."""
+
+    hrefs_to_objects: Dict[str, "STACObject_Type"]
+    """STAC Object HREFs matched to their cached object."""
+
+    ids_to_collections: Dict[str, "Collection_Type"]
+    """Map of collection IDs to collections."""
+
+    _collection_cache: Optional["ResolvedObjectCollectionCache"]
+
     def __init__(
         self,
         id_keys_to_objects: Optional[Dict[str, "STACObject_Type"]] = None,
@@ -69,7 +81,7 @@ def __init__(
         self.hrefs_to_objects = hrefs_to_objects or {}
         self.ids_to_collections = ids_to_collections or {}
 
-        self._collection_cache: Optional[ResolvedObjectCollectionCache] = None
+        self._collection_cache = None
 
     def get_or_cache(self, obj: "STACObject_Type") -> "STACObject_Type":
         """Gets the STACObject that is the cached version of the given STACObject; or, if
@@ -233,6 +245,9 @@ class CollectionCache:
     in common properties.
     """
 
+    cached_ids: Dict[str, Union["Collection_Type", Dict[str, Any]]]
+    cached_hrefs: Dict[str, Union["Collection_Type", Dict[str, Any]]]
+
     def __init__(
         self,
         cached_ids: Optional[
@@ -274,6 +289,9 @@ def cache(
 
 
 class ResolvedObjectCollectionCache(CollectionCache):
+
+    resolved_object_cache: ResolvedObjectCache
+
     def __init__(
         self,
         resolved_object_cache: ResolvedObjectCache,
diff --git a/pystac/catalog.py b/pystac/catalog.py
index 3d00f3370..ca466a0e9 100644
--- a/pystac/catalog.py
+++ b/pystac/catalog.py
@@ -49,7 +49,7 @@ class CatalogType(StringEnum):
 
     See:
         :stac-spec:`The best practices documentation on self-contained catalogs
-            <best-practices.md#self-contained-catalogs>`
+        <best-practices.md#self-contained-catalogs>`
     """
 
     ABSOLUTE_PUBLISHED = "ABSOLUTE_PUBLISHED"
@@ -59,7 +59,7 @@ class CatalogType(StringEnum):
 
     See:
         :stac-spec:`The best practices documentation on published catalogs
-            <best-practices.md#published-catalogs>`
+        <best-practices.md#published-catalogs>`
     """
 
     RELATIVE_PUBLISHED = "RELATIVE_PUBLISHED"
@@ -69,7 +69,7 @@ class CatalogType(StringEnum):
 
     See:
         :stac-spec:`The best practices documentation on published catalogs
-            <best-practices.md#published-catalogs>`
+        <best-practices.md#published-catalogs>`
     """
 
     @classmethod
@@ -122,21 +122,33 @@ class Catalog(STACObject):
         href : Optional HREF for this catalog, which be set as the
             catalog's self link's HREF.
         catalog_type : Optional catalog type for this catalog. Must
-            be one of the values in :class`~pystac.CatalogType`.
-
-    Attributes:
-        id : Identifier for the catalog.
-        description : Detailed multi-line description to fully explain the catalog.
-        title : Optional short descriptive one-line title for the catalog.
-        stac_extensions : Optional list of extensions the Catalog
-            implements.
-        extra_fields : Extra fields that are part of the top-level JSON
-            properties of the Catalog.
-        links : A list of :class:`~pystac.Link` objects representing
-            all links associated with this Catalog.
-        catalog_type : The catalog type. Defaults to ABSOLUTE_PUBLISHED
+            be one of the values in :class:`~pystac.CatalogType`.
     """
 
+    catalog_type: CatalogType
+    """The catalog type. Defaults to :attr:`CatalogType.ABSOLUTE_PUBLISHED`."""
+
+    description: str
+    """Detailed multi-line description to fully explain the catalog."""
+
+    extra_fields: Dict[str, Any]
+    """Extra fields that are part of the top-level JSON properties of the Catalog."""
+
+    id: str
+    """Identifier for the catalog."""
+
+    links: List[Link]
+    """A list of :class:`~pystac.Link` objects representing all links associated with
+    this Catalog."""
+
+    title: Optional[str]
+    """Optional short descriptive one-line title for the catalog."""
+
+    stac_extensions: List[str]
+    """List of extensions the Catalog implements."""
+
+    _resolved_objects: ResolvedObjectCache
+
     STAC_OBJECT_TYPE = pystac.STACObjectType.CATALOG
 
     _stac_io: Optional[pystac.StacIO] = None
@@ -758,7 +770,7 @@ def save(
                     child_dest_href = make_absolute_href(
                         rel_href, dest_href, start_is_dir=True
                     )
-                    child.save(dest_href=child_dest_href)
+                    child.save(dest_href=os.path.dirname(child_dest_href))
                 else:
                     child.save()
 
diff --git a/pystac/collection.py b/pystac/collection.py
index 29fea8453..b40a8f3ae 100644
--- a/pystac/collection.py
+++ b/pystac/collection.py
@@ -23,6 +23,7 @@
 from pystac.catalog import Catalog
 from pystac.layout import HrefLayoutStrategy
 from pystac.link import Link
+from pystac.provider import Provider
 from pystac.utils import datetime_to_str
 from pystac.serialization import (
     identify_stac_object_type,
@@ -439,30 +440,44 @@ class Collection(Catalog):
             either a set of values or statistics such as a range.
         extra_fields : Extra fields that are part of the top-level
             JSON properties of the Collection.
-
-    Attributes:
-        id : Identifier for the collection.
-        description : Detailed multi-line description to fully explain the
-            collection.
-        extent : Spatial and temporal extents that describe the bounds of
-            all items contained within this Collection.
-        title : Optional short descriptive one-line title for the
-            collection.
-        stac_extensions : Optional list of extensions the Collection
-            implements.
-        keywords : Optional list of keywords describing the
-            collection.
-        providers : Optional list of providers of this
-            Collection.
-        assets : Optional map of Assets
-        summaries : An optional map of property summaries,
-            either a set of values or statistics such as a range.
-        links : A list of :class:`~pystac.Link` objects representing
-            all links associated with this Collection.
-        extra_fields : Extra fields that are part of the top-level
-            JSON properties of the Catalog.
     """
 
+    assets: Dict[str, Asset]
+    """Map of Assets"""
+
+    description: str
+    """Detailed multi-line description to fully explain the collection."""
+
+    extent: Extent
+    """Spatial and temporal extents that describe the bounds of all items contained
+    within this Collection."""
+
+    id: str
+    """Identifier for the collection."""
+
+    stac_extensions: List[str]
+    """List of extensions the Collection implements."""
+
+    title: Optional[str]
+    """Optional short descriptive one-line title for the collection."""
+
+    keywords: Optional[List[str]]
+    """Optional list of keywords describing the collection."""
+
+    providers: Optional[List[Provider]]
+    """Optional list of providers of this Collection."""
+
+    summaries: Summaries
+    """A map of property summaries, either a set of values or statistics such as a
+    range."""
+
+    links: List[Link]
+    """A list of :class:`~pystac.Link` objects representing all links associated with
+    this Collection."""
+
+    extra_fields: Dict[str, Any]
+    """Extra fields that are part of the top-level JSON properties of the Collection."""
+
     STAC_OBJECT_TYPE = STACObjectType.COLLECTION
 
     DEFAULT_FILE_NAME = "collection.json"
@@ -501,7 +516,7 @@ def __init__(
         self.providers = providers
         self.summaries = summaries or Summaries.empty()
 
-        self.assets: Dict[str, Asset] = {}
+        self.assets = {}
 
     def __repr__(self) -> str:
         return "<Collection id={}>".format(self.id)
diff --git a/pystac/extensions/datacube.py b/pystac/extensions/datacube.py
index 1eac0bbdf..2758b2d4e 100644
--- a/pystac/extensions/datacube.py
+++ b/pystac/extensions/datacube.py
@@ -12,7 +12,7 @@
     PropertiesExtension,
 )
 from pystac.extensions.hooks import ExtensionHooks
-from pystac.utils import StringEnum, get_required
+from pystac.utils import StringEnum, get_required, map_opt
 
 T = TypeVar("T", pystac.Collection, pystac.Item, pystac.Asset)
 
@@ -501,6 +501,9 @@ def unit(self, v: Optional[str]) -> None:
     def from_dict(d: Dict[str, Any]) -> "Variable":
         return Variable(d)
 
+    def to_dict(self) -> Dict[str, Any]:
+        return self.properties
+
 
 class DatacubeExtension(
     Generic[T],
@@ -553,6 +556,15 @@ def variables(self) -> Optional[Dict[str, Variable]]:
             return None
         return {k: Variable.from_dict(v) for k, v in result.items()}
 
+    @variables.setter
+    def variables(self, v: Optional[Dict[str, Variable]]) -> None:
+        self._set_property(
+            VARIABLES_PROP,
+            map_opt(
+                lambda variables: {k: var.to_dict() for k, var in variables.items()}, v
+            ),
+        )
+
     @classmethod
     def get_schema_uri(cls) -> str:
         return SCHEMA_URI
diff --git a/pystac/extensions/eo.py b/pystac/extensions/eo.py
index 3d56095ee..d9d8e82ad 100644
--- a/pystac/extensions/eo.py
+++ b/pystac/extensions/eo.py
@@ -44,6 +44,8 @@ class Band:
     Use :meth:`Band.create` to create a new Band.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
diff --git a/pystac/extensions/file.py b/pystac/extensions/file.py
index d4af7810f..02d8b428b 100644
--- a/pystac/extensions/file.py
+++ b/pystac/extensions/file.py
@@ -3,7 +3,7 @@
 https://github.com/stac-extensions/file
 """
 
-from typing import Any, Dict, List, Optional, Union
+from typing import Any, Dict, Iterable, List, Optional, Union
 
 import pystac
 from pystac.extensions.base import ExtensionManagementMixin, PropertiesExtension
@@ -13,7 +13,7 @@
     STACJSONDescription,
     STACVersionID,
 )
-from pystac.utils import StringEnum, get_required
+from pystac.utils import StringEnum, get_required, map_opt
 
 SCHEMA_URI = "https://stac-extensions.github.io/file/v2.0.0/schema.json"
 
@@ -83,6 +83,13 @@ def summary(self) -> str:
     def summary(self, v: str) -> None:
         self.properties["summary"] = v
 
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> "MappingObject":
+        return cls.create(**d)
+
+    def to_dict(self) -> Dict[str, Any]:
+        return self.properties
+
 
 class FileExtension(
     PropertiesExtension, ExtensionManagementMixin[Union[pystac.Item, pystac.Collection]]
@@ -99,6 +106,16 @@ class FileExtension(
        >>> file_ext = FileExtension.ext(asset)
     """
 
+    asset_href: str
+    """The ``href`` value of the :class:`~pystac.Asset` being extended."""
+
+    properties: Dict[str, Any]
+    """The :class:`~pystac.Asset` fields, including extension properties."""
+
+    additional_read_properties: Optional[Iterable[Dict[str, Any]]] = None
+    """If present, this will be a list containing 1 dictionary representing the
+    properties of the owning :class:`~pystac.Item`."""
+
     def __init__(self, asset: pystac.Asset):
         self.asset_href = asset.href
         self.properties = asset.extra_fields
@@ -180,11 +197,21 @@ def values(self) -> Optional[List[MappingObject]]:
         values that are in the file and describe their meaning. See the
         :stac-ext:`Mapping Object <file#mapping-object>` docs for an example. If given,
         at least one array element is required."""
-        return self._get_property(VALUES_PROP, List[MappingObject])
+        return map_opt(
+            lambda values: [
+                MappingObject.from_dict(mapping_obj) for mapping_obj in values
+            ],
+            self._get_property(VALUES_PROP, List[Dict[str, Any]]),
+        )
 
     @values.setter
     def values(self, v: Optional[List[MappingObject]]) -> None:
-        self._set_property(VALUES_PROP, v)
+        self._set_property(
+            VALUES_PROP,
+            map_opt(
+                lambda values: [mapping_obj.to_dict() for mapping_obj in values], v
+            ),
+        )
 
     @classmethod
     def get_schema_uri(cls) -> str:
diff --git a/pystac/extensions/hooks.py b/pystac/extensions/hooks.py
index 3702af987..65bcb5e1c 100644
--- a/pystac/extensions/hooks.py
+++ b/pystac/extensions/hooks.py
@@ -64,6 +64,8 @@ def migrate(
 
 
 class RegisteredExtensionHooks:
+    hooks: Dict[str, ExtensionHooks]
+
     def __init__(self, hooks: Iterable[ExtensionHooks]):
         self.hooks = dict([(e.schema_uri, e) for e in hooks])
 
diff --git a/pystac/extensions/item_assets.py b/pystac/extensions/item_assets.py
index 76f4118f1..a37197e23 100644
--- a/pystac/extensions/item_assets.py
+++ b/pystac/extensions/item_assets.py
@@ -29,6 +29,8 @@ class AssetDefinition:
     See the :stac-ext:`Asset Object <item-assets#asset-object>` for details.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
@@ -52,7 +54,7 @@ def title(self, v: Optional[str]) -> None:
     @property
     def description(self) -> Optional[str]:
         """Gets or sets a description of the Asset providing additional details, such as
-        how it was processed or created. `CommonMark 0.29 <http://commonmark.org/`__
+        how it was processed or created. `CommonMark 0.29 <http://commonmark.org/>`__
         syntax MAY be used for rich text representation."""
         return self.properties.get(ASSET_DESC_PROP)
 
@@ -119,6 +121,8 @@ def create_asset(self, href: str) -> pystac.Asset:
 
 
 class ItemAssetsExtension(ExtensionManagementMixin[pystac.Collection]):
+    collection: pystac.Collection
+
     def __init__(self, collection: pystac.Collection) -> None:
         self.collection = collection
 
diff --git a/pystac/extensions/label.py b/pystac/extensions/label.py
index 0a8af0dda..cdaed7b47 100644
--- a/pystac/extensions/label.py
+++ b/pystac/extensions/label.py
@@ -67,6 +67,8 @@ class LabelClasses:
     Use :meth:`LabelClasses.create` to create a new instance from property values.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]):
         self.properties = properties
 
@@ -150,6 +152,8 @@ class LabelCount:
     Use :meth:`LabelCount.create` to create a new instance.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]):
         self.properties = properties
 
@@ -214,6 +218,8 @@ class LabelStatistics:
     Use :meth:`LabelStatistics.create` to create a new instance.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
@@ -278,6 +284,8 @@ class LabelOverview:
     Use :meth:`LabelOverview.create` to create a new instance.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]):
         self.properties = properties
 
@@ -437,6 +445,9 @@ class LabelExtension(ExtensionManagementMixin[Union[pystac.Item, pystac.Collecti
        >>> label_ext = LabelExtension.ext(item)
     """
 
+    obj: pystac.Item
+    schema_uri: str
+
     def __init__(self, item: pystac.Item) -> None:
         self.obj = item
         self.schema_uri = SCHEMA_URI
diff --git a/pystac/extensions/pointcloud.py b/pystac/extensions/pointcloud.py
index 67b2f0b01..9917253af 100644
--- a/pystac/extensions/pointcloud.py
+++ b/pystac/extensions/pointcloud.py
@@ -2,7 +2,7 @@
 
 https://github.com/stac-extensions/pointcloud
 """
-from typing import Any, Dict, Generic, List, Optional, TypeVar, cast, Union
+from typing import Any, Dict, Iterable, Generic, List, Optional, TypeVar, cast, Union
 
 import pystac
 from pystac.extensions.base import (
@@ -54,6 +54,8 @@ class Schema:
     properties.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
@@ -133,6 +135,8 @@ class Statistic:
     Use :meth:`Statistic.create` to create a new instance of
     ``Statistic`` from property values."""
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
@@ -475,6 +479,9 @@ class ItemPointcloudExtension(PointcloudExtension[pystac.Item]):
     :meth:`PointcloudExtension.ext` on an :class:`~pystac.Item` to extend it.
     """
 
+    item: pystac.Item
+    properties: Dict[str, Any]
+
     def __init__(self, item: pystac.Item):
         self.item = item
         self.properties = item.properties
@@ -492,6 +499,16 @@ class AssetPointcloudExtension(PointcloudExtension[pystac.Asset]):
     :meth:`PointcloudExtension.ext` on an :class:`~pystac.Asset` to extend it.
     """
 
+    asset_href: str
+    """The ``href`` value of the :class:`~pystac.Asset` being extended."""
+
+    properties: Dict[str, Any]
+    """The :class:`~pystac.Asset` fields, including extension properties."""
+
+    additional_read_properties: Optional[Iterable[Dict[str, Any]]] = None
+    """If present, this will be a list containing 1 dictionary representing the
+    properties of the owning :class:`~pystac.Item`."""
+
     def __init__(self, asset: pystac.Asset):
         self.asset_href = asset.href
         self.properties = asset.extra_fields
diff --git a/pystac/extensions/raster.py b/pystac/extensions/raster.py
index 9a1b62ad2..2b1b2c2fa 100644
--- a/pystac/extensions/raster.py
+++ b/pystac/extensions/raster.py
@@ -48,6 +48,8 @@ class Statistics:
     Use Statistics.create to create a new Statistics instance.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Optional[float]]) -> None:
         self.properties = properties
 
@@ -208,6 +210,8 @@ class Histogram:
     Use Band.create to create a new Band.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
@@ -342,6 +346,8 @@ class RasterBand:
     Use Band.create to create a new Band.
     """
 
+    properties: Dict[str, Any]
+
     def __init__(self, properties: Dict[str, Any]) -> None:
         self.properties = properties
 
diff --git a/pystac/extensions/scientific.py b/pystac/extensions/scientific.py
index 1f3561fed..c4f6ab485 100644
--- a/pystac/extensions/scientific.py
+++ b/pystac/extensions/scientific.py
@@ -54,6 +54,9 @@ def doi_to_url(doi: str) -> str:
 class Publication:
     """Helper for Publication entries."""
 
+    citation: Optional[str]
+    doi: Optional[str]
+
     def __init__(self, doi: Optional[str], citation: Optional[str]) -> None:
         self.doi = doi
         self.citation = citation
@@ -114,6 +117,8 @@ class ScientificExtension(
        >>> sci_ext = ScientificExtension.ext(item)
     """
 
+    obj: pystac.STACObject
+
     def __init__(self, obj: pystac.STACObject) -> None:
         self.obj = obj
 
diff --git a/pystac/extensions/table.py b/pystac/extensions/table.py
index 44b38ba2b..06571cfb9 100644
--- a/pystac/extensions/table.py
+++ b/pystac/extensions/table.py
@@ -183,7 +183,7 @@ def columns(self, v: List[Column]) -> None:
     @property
     def primary_geometry(self) -> Optional[str]:
         """The primary geometry column name"""
-        return self.properties.get(PRIMARY_GEOMETRY_PROP)
+        return self._get_property(PRIMARY_GEOMETRY_PROP, str)
 
     @primary_geometry.setter
     def primary_geometry(self, v: Optional[str]) -> None:
@@ -195,7 +195,7 @@ def primary_geometry(self, v: Optional[str]) -> None:
     @property
     def row_count(self) -> Optional[int]:
         """The number of rows in the dataset"""
-        return self.properties.get(ROW_COUNT_PROP)
+        return self._get_property(ROW_COUNT_PROP, int)
 
     @row_count.setter
     def row_count(self, v: Optional[int]) -> None:
diff --git a/pystac/extensions/version.py b/pystac/extensions/version.py
index 97478a50e..1d846e359 100644
--- a/pystac/extensions/version.py
+++ b/pystac/extensions/version.py
@@ -3,7 +3,7 @@
 https://github.com/stac-extensions/version
 """
 from pystac.utils import get_required, map_opt
-from typing import Generic, List, Optional, TypeVar, Union, cast
+from typing import Any, Dict, Generic, List, Optional, TypeVar, Union, cast
 
 import pystac
 from pystac.utils import StringEnum
@@ -226,6 +226,10 @@ class CollectionVersionExtension(VersionExtension[pystac.Collection]):
     :meth:`VersionExtension.ext` on an :class:`~pystac.Collection` to extend it.
     """
 
+    collection: pystac.Collection
+    links: List[pystac.Link]
+    properties: Dict[str, Any]
+
     def __init__(self, collection: pystac.Collection):
         self.collection = collection
         self.properties = collection.extra_fields
@@ -245,6 +249,10 @@ class ItemVersionExtension(VersionExtension[pystac.Item]):
     :meth:`VersionExtension.ext` on an :class:`~pystac.Item` to extend it.
     """
 
+    item: pystac.Item
+    links: List[pystac.Link]
+    properties: Dict[str, Any]
+
     def __init__(self, item: pystac.Item):
         self.item = item
         self.properties = item.properties
diff --git a/pystac/item.py b/pystac/item.py
index 14c660e17..b9730acba 100644
--- a/pystac/item.py
+++ b/pystac/item.py
@@ -49,33 +49,49 @@ class Item(STACObject):
             belongs to.
         extra_fields : Extra fields that are part of the top-level JSON
             properties of the Item.
-
-    Attributes:
-        id : Provider identifier. Unique within the STAC.
-        geometry : Defines the full footprint of the asset represented by this
-            item, formatted according to
-            `RFC 7946, section 3.1 (GeoJSON) <https://tools.ietf.org/html/rfc7946>`_.
-        bbox :  Bounding Box of the asset represented by this item
-            using either 2D or 3D geometries. The length of the array is 2*n where n
-            is the number of dimensions. Could also be None in the case of a null
-            geometry.
-        datetime : Datetime associated with this item. If None,
-            the start_datetime and end_datetime in the common_metadata
-            will supply the datetime range of the Item.
-        properties : A dictionary of additional metadata for the item.
-        stac_extensions : Optional list of extensions the Item
-            implements.
-        collection : Collection that this item is a part of.
-        links : A list of :class:`~pystac.Link` objects representing
-            all links associated with this STACObject.
-        assets : Dictionary of asset objects that can be downloaded,
-            each with a unique key.
-        collection_id : The Collection ID that this item belongs to, if
-            any.
-        extra_fields : Extra fields that are part of the top-level JSON
-            properties of the Item.
     """
 
+    assets: Dict[str, Asset]
+    """Dictionary of :class:`~pystac.Asset` objects, each with a unique key."""
+
+    bbox: Optional[List[float]]
+    """Bounding Box of the asset represented by this item using either 2D or 3D
+    geometries. The length of the array is 2*n where n is the number of dimensions.
+    Could also be None in the case of a null geometry."""
+
+    collection: Optional[Collection]
+    """:class:`~pystac.Collection` to which this Item belongs, if any."""
+
+    collection_id: Optional[str]
+    """The Collection ID that this item belongs to, if any."""
+
+    datetime: Optional[Datetime]
+    """Datetime associated with this item. If ``None``, then
+    :attr:`~pystac.CommonMetadata.start_datetime` and
+    :attr:`~pystac.CommonMetadata.end_datetime` in :attr:`~pystac.Item.common_metadata`
+    will supply the datetime range of the Item."""
+
+    extra_fields: Dict[str, Any]
+    """Extra fields that are part of the top-level JSON fields the Item."""
+
+    geometry: Optional[Dict[str, Any]]
+    """Defines the full footprint of the asset represented by this item, formatted
+    according to `RFC 7946, section 3.1 (GeoJSON)
+    <https://tools.ietf.org/html/rfc7946>`_."""
+
+    id: str
+    """Provider identifier. Unique within the STAC."""
+
+    links: List[Link]
+    """A list of :class:`~pystac.Link` objects representing all links associated with
+    this Item."""
+
+    properties: Dict[str, Any]
+    """A dictionary of additional metadata for the Item."""
+
+    stac_extensions: List[str]
+    """List of extensions the Item implements."""
+
     STAC_OBJECT_TYPE = STACObjectType.ITEM
 
     def __init__(
diff --git a/pystac/layout.py b/pystac/layout.py
index ccc87d407..27fe31c34 100644
--- a/pystac/layout.py
+++ b/pystac/layout.py
@@ -75,6 +75,16 @@ class LayoutTemplate:
             will be used in case a value cannot be derived from a stac object.
     """
 
+    template: str
+    """The template string to use."""
+
+    defaults: Dict[str, str]
+    """A dictionary of template vars to values. These values will be used in case a
+    value cannot be derived from a stac object."""
+
+    template_vars: List[str]
+    """List of template vars to use when templating."""
+
     # Special template vars specific to Items
     ITEM_TEMPLATE_VARS = ["date", "year", "month", "day", "collection"]
 
@@ -85,7 +95,7 @@ def __init__(
         self.defaults = defaults or {}
 
         # Generate list of template vars
-        template_vars: List[str] = []
+        template_vars = []
         for formatter_parse_result in Formatter().parse(template):
             v = formatter_parse_result[1]
             if v is not None:
@@ -287,6 +297,24 @@ class CustomLayoutStrategy(HrefLayoutStrategy):
             :class:`~pystac.layout.BestPracticesLayoutStrategy`
     """
 
+    catalog_func: Optional[Callable[["Catalog_Type", str, bool], str]]
+    """A function that takes a :class:`~pystac.Catalog`, a parent directory, and a
+    boolean specifying whether or not this Catalog is the root. If it is the root, it
+    is usually best to not create a subdirectory and put the Catalog file directly
+    in the parent directory. Must return the string path."""
+
+    collection_func: Optional[Callable[["Collection_Type", str, bool], str]]
+    """A function that is used for collections in the same manner as
+    :attr:`~catalog_func`. This takes the same parameters."""
+
+    fallback_strategy: HrefLayoutStrategy
+    """The fallback strategy to use if a function is not provided for a stac object
+    type. Defaults to :class:`~pystac.layout.BestPracticesLayoutStrategy`."""
+
+    item_func: Optional[Callable[["Item_Type", str], str]]
+    """An optional function that takes an :class:`~pystac.Item` and a parent directory
+    and returns the path to be used for the Item."""
+
     def __init__(
         self,
         catalog_func: Optional[Callable[["Catalog_Type", str, bool], str]] = None,
@@ -299,7 +327,7 @@ def __init__(
         self.catalog_func = catalog_func
         if fallback_strategy is None:
             fallback_strategy = BestPracticesLayoutStrategy()
-        self.fallback_strategy: HrefLayoutStrategy = fallback_strategy
+        self.fallback_strategy = fallback_strategy
 
     def get_catalog_href(
         self, cat: "Catalog_Type", parent_dir: str, is_root: bool
@@ -352,6 +380,22 @@ class TemplateLayoutStrategy(HrefLayoutStrategy):
             :class:`~pystac.layout.BestPracticesLayoutStrategy`
     """
 
+    catalog_template: Optional[LayoutTemplate]
+    """The template string to use for catalog paths. Must be a valid template string
+    that can be used by :class:`~pystac.layout.LayoutTemplate`."""
+
+    collection_template: Optional[LayoutTemplate]
+    """The template string to use for collection paths. Must be a valid template string
+    that can be used by :class:`~pystac.layout.LayoutTemplate`."""
+
+    fallback_strategy: HrefLayoutStrategy
+    """The fallback strategy to use if a template is not provided. Defaults to
+    :class:`~pystac.layout.BestPracticesLayoutStrategy`."""
+
+    item_template: Optional[LayoutTemplate]
+    """The template string to use for item paths. Must be a valid template string that
+    can be used by :class:`~pystac.layout.LayoutTemplate`."""
+
     def __init__(
         self,
         catalog_template: Optional[str] = None,
@@ -373,7 +417,7 @@ def __init__(
 
         if fallback_strategy is None:
             fallback_strategy = BestPracticesLayoutStrategy()
-        self.fallback_strategy: HrefLayoutStrategy = fallback_strategy
+        self.fallback_strategy = fallback_strategy
 
     def get_catalog_href(
         self, cat: "Catalog_Type", parent_dir: str, is_root: bool
diff --git a/pystac/link.py b/pystac/link.py
index a6f8e9431..919aa0db3 100644
--- a/pystac/link.py
+++ b/pystac/link.py
@@ -320,13 +320,14 @@ def is_resolved(self) -> bool:
     def to_dict(self, transform_href: bool = True) -> Dict[str, Any]:
         """Generate a dictionary representing the JSON of this serialized Link.
 
-        Returns:
-            dict: A serialization of the Link that can be written out as JSON.
-            transform_href: If True, transform the HREF based on the type of
+        Args:
+            transform_href : If ``True``, transform the HREF based on the type of
                 catalog the owner belongs to (if any). I.e. if the link owner
                 belongs to a root catalog that is RELATIVE_PUBLISHED or SELF_CONTAINED,
                 the HREF will be transformed to be relative to the catalog root
                 if this is a hierarchical link relation.
+        Returns:
+            dict : A serialization of the Link that can be written out as JSON.
         """
 
         d: Dict[str, Any] = {
diff --git a/pystac/serialization/identify.py b/pystac/serialization/identify.py
index 98daa3140..ab10c4c14 100644
--- a/pystac/serialization/identify.py
+++ b/pystac/serialization/identify.py
@@ -37,6 +37,10 @@ class STACVersionID:
     For instance, ``1.0.0-beta.2 < 1.0.0``
     """
 
+    version_string: str
+    version_core: str
+    version_prerelease: Optional[str]
+
     def __init__(self, version_string: str) -> None:
         self.version_string = version_string
 
@@ -76,6 +80,9 @@ def __lt__(self, other: object) -> bool:
 class STACVersionRange:
     """Defines a range of STAC versions."""
 
+    min_version: STACVersionID
+    max_version: STACVersionID
+
     def __init__(
         self,
         min_version: Union[str, STACVersionID] = "0.8.0",
@@ -149,6 +156,10 @@ class STACJSONDescription:
             object implements
     """
 
+    object_type: "STACObjectType_Type"
+    version_range: STACVersionRange
+    extensions: Set[str]
+
     def __init__(
         self,
         object_type: "STACObjectType_Type",
diff --git a/pystac/stac_object.py b/pystac/stac_object.py
index d6871d2d5..157c6d0c2 100644
--- a/pystac/stac_object.py
+++ b/pystac/stac_object.py
@@ -17,10 +17,10 @@ class STACObjectType(StringEnum):
 
 
 class STACObject(ABC):
-    """A STACObject is the base class for any element of STAC that
-    has links e.g. (Catalogs, Collections, or Items). A STACObject has
-    common functionality, can be converted to and from Python ``dicts`` representing
-    JSON, and can be cloned or copied.
+    """A base class for other PySTAC classes that contains a variety of useful
+    methods for dealing with links, copying objects, accessing extensions, and reading
+    and writing files. You shouldn't use STACObject directly, but instead access this
+    functionality through the implementing classes.
     """
 
     id: str
@@ -36,7 +36,7 @@ class STACObject(ABC):
     STAC_OBJECT_TYPE: STACObjectType
 
     def __init__(self, stac_extensions: List[str]) -> None:
-        self.links: List[Link] = []
+        self.links = []
         self.stac_extensions = stac_extensions
 
     def validate(self) -> List[Any]:
diff --git a/pystac/summaries.py b/pystac/summaries.py
index 3d55ff059..9652b4b7b 100644
--- a/pystac/summaries.py
+++ b/pystac/summaries.py
@@ -58,6 +58,9 @@ def __lt__(self: "T", other: "T") -> bool:
 
 
 class RangeSummary(Generic[T]):
+    minimum: T
+    maximum: T
+
     def __init__(self, minimum: T, maximum: T):
         self.minimum = minimum
         self.maximum = maximum
@@ -116,6 +119,8 @@ class Summarizer:
         If no file is passed, a default one will be used.
     """
 
+    summaryfields: Dict[str, SummaryStrategy]
+
     def __init__(self, fields: Optional[str] = None):
         fieldspath = fields or FIELDS_JSON_URL
         try:
@@ -132,7 +137,7 @@ def __init__(self, fields: Optional[str] = None):
         self._set_field_definitions(jsonfields)
 
     def _set_field_definitions(self, fields: Dict[str, Any]) -> None:
-        self.summaryfields: Dict[str, SummaryStrategy] = {}
+        self.summaryfields = {}
         for name, desc in fields["metadata"].items():
             if isinstance(desc, dict):
                 strategy_value = desc.get("summary", True)
@@ -194,16 +199,24 @@ def summarize(
 
 
 class Summaries:
+    _summaries: Dict[str, Any]
+
+    lists: Dict[str, List[Any]]
+    other: Dict[str, Any]
+    ranges: Dict[str, RangeSummary[Any]]
+    schemas: Dict[str, Dict[str, Any]]
+    maxcount: int
+
     def __init__(
         self, summaries: Dict[str, Any], maxcount: int = DEFAULT_MAXCOUNT
     ) -> None:
         self._summaries = summaries
         self.maxcount = maxcount
 
-        self.lists: Dict[str, List[Any]] = {}
-        self.ranges: Dict[str, RangeSummary[Any]] = {}
-        self.schemas: Dict[str, Dict[str, Any]] = {}
-        self.other: Dict[str, Any] = {}
+        self.lists = {}
+        self.ranges = {}
+        self.schemas = {}
+        self.other = {}
 
         for prop_key, summary in summaries.items():
             self.add(prop_key, summary)
diff --git a/pystac/utils.py b/pystac/utils.py
index 8232e7a0a..f79493db8 100644
--- a/pystac/utils.py
+++ b/pystac/utils.py
@@ -241,10 +241,13 @@ def make_absolute_href(
     parsed_start = safe_urlparse(start_href)
     parsed_source = safe_urlparse(source_href)
 
-    if JoinType.from_parsed_uri(parsed_start) == JoinType.PATH:
-        return _make_absolute_href_path(parsed_source, parsed_start, start_is_dir)
-    else:
+    if (
+        JoinType.from_parsed_uri(parsed_source) == JoinType.URL
+        or JoinType.from_parsed_uri(parsed_start) == JoinType.URL
+    ):
         return _make_absolute_href_url(parsed_source, parsed_start, start_is_dir)
+    else:
+        return _make_absolute_href_path(parsed_source, parsed_start, start_is_dir)
 
 
 def is_absolute_href(href: str) -> bool:
diff --git a/pystac/validation/stac_validator.py b/pystac/validation/stac_validator.py
index aff974997..92979c532 100644
--- a/pystac/validation/stac_validator.py
+++ b/pystac/validation/stac_validator.py
@@ -131,6 +131,9 @@ class JsonSchemaSTACValidator(STACValidator):
     This class requires the ``jsonschema`` library to be installed.
     """
 
+    schema_uri_map: SchemaUriMap
+    schema_cache: Dict[str, Dict[str, Any]]
+
     def __init__(self, schema_uri_map: Optional[SchemaUriMap] = None) -> None:
         if jsonschema is None:
             raise Exception("Cannot instantiate, requires jsonschema package")
@@ -140,7 +143,7 @@ def __init__(self, schema_uri_map: Optional[SchemaUriMap] = None) -> None:
         else:
             self.schema_uri_map = DefaultSchemaUriMap()
 
-        self.schema_cache: Dict[str, Dict[str, Any]] = {}
+        self.schema_cache = {}
 
     def get_schema_from_uri(self, schema_uri: str) -> Tuple[Dict[str, Any], Any]:
         if schema_uri not in self.schema_cache:
diff --git a/pystac/version.py b/pystac/version.py
index 5f69a1375..6a72146e6 100644
--- a/pystac/version.py
+++ b/pystac/version.py
@@ -1,7 +1,7 @@
 import os
 from typing import Optional
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 """Library version"""
 
 
diff --git a/requirements-dev.txt b/requirements-dev.txt
index b28567898..aa1b2b78c 100644
--- a/requirements-dev.txt
+++ b/requirements-dev.txt
@@ -1,2 +1,4 @@
 -r ./requirements-docs.txt
 -r ./requirements-test.txt
+
+jupyter==1.0.0
\ No newline at end of file
diff --git a/requirements-docs.txt b/requirements-docs.txt
index d9687c839..227a9e4ba 100644
--- a/requirements-docs.txt
+++ b/requirements-docs.txt
@@ -1,6 +1,7 @@
-ipython==7.29.0
-Sphinx==4.3.0
+ipython==8.0.0
+Sphinx==4.4.0
 sphinxcontrib-fulltoc==1.2.0
-nbsphinx==0.8.7
-
-jinja2<4.0
\ No newline at end of file
+nbsphinx==0.8.8
+pydata-sphinx-theme==0.8.0
+sphinx-panels==0.6.0
+jinja2<4.0
diff --git a/requirements-test.txt b/requirements-test.txt
index 73f6bd599..be6e5d819 100644
--- a/requirements-test.txt
+++ b/requirements-test.txt
@@ -1,17 +1,17 @@
-mypy==0.910
+mypy==0.931
 flake8==4.0.1
-black==21.10b0
+black==21.12b0
 
 codespell==2.1.0
 
-jsonschema==4.2.1
-coverage==6.1.2
+jsonschema==4.4.0
+coverage==6.2
 doc8==0.10.1
 
-types-python-dateutil==2.8.2
-types-orjson==3.6.1
+types-python-dateutil==2.8.7
+types-orjson==3.6.2
 
-pre-commit==2.15.0
+pre-commit==2.16.0
 
 # optional dependencies
-orjson==3.6.4
\ No newline at end of file
+orjson==3.6.5
diff --git a/tests/data-files/datacube/item.json b/tests/data-files/datacube/item.json
index c33b13d52..9fadf216b 100644
--- a/tests/data-files/datacube/item.json
+++ b/tests/data-files/datacube/item.json
@@ -97,7 +97,18 @@
                     "blue"
                 ]
             }
-        }
+        },
+        "cube:variables": {
+            "temp": {
+              "dimensions": [
+                "time",
+                "y",
+                "x",
+                "pressure_levels"
+              ],
+              "type": "data"
+            }
+          }
     },
     "assets": {
         "data": {
diff --git a/tests/extensions/test_datacube.py b/tests/extensions/test_datacube.py
index 68ea84e43..ef1f60e8c 100644
--- a/tests/extensions/test_datacube.py
+++ b/tests/extensions/test_datacube.py
@@ -1,7 +1,7 @@
 import unittest
 import pystac
 from pystac import ExtensionTypeError
-from pystac.extensions.datacube import DatacubeExtension
+from pystac.extensions.datacube import DatacubeExtension, Variable
 
 from tests.utils import TestCases
 
@@ -61,3 +61,29 @@ def test_should_raise_exception_when_passing_invalid_extension_object(
             DatacubeExtension.ext,
             object(),
         )
+
+    def test_get_variables(self) -> None:
+        item = pystac.Item.from_file(self.example_uri)
+        dc_ext = DatacubeExtension.ext(item)
+
+        assert dc_ext.variables is not None
+        self.assertIsInstance(dc_ext.variables, dict)
+        self.assertNotEqual(dc_ext.variables, {})
+
+        for var in dc_ext.variables.values():
+            self.assertIsInstance(var, Variable)
+
+    def test_set_variables(self) -> None:
+        item = pystac.Item.from_file(self.example_uri)
+        dc_ext = DatacubeExtension.ext(item)
+
+        new_variable = Variable.from_dict(
+            {"dimensions": ["time", "y", "x", "pressure_levels"], "type": "data"}
+        )
+        new_variables = {"temp": new_variable}
+
+        dc_ext.variables = new_variables
+
+        self.assertEqual(
+            item.properties["cube:variables"], {"temp": new_variable.to_dict()}
+        )
diff --git a/tests/extensions/test_file.py b/tests/extensions/test_file.py
index d470031e5..40f013f4d 100644
--- a/tests/extensions/test_file.py
+++ b/tests/extensions/test_file.py
@@ -132,11 +132,17 @@ def test_item_asset_values(self) -> None:
         item = pystac.Item.from_file(self.FILE_ITEM_EXAMPLE_URI)
         asset = item.assets["thumbnail"]
         file_ext = FileExtension.ext(asset)
-        values = [MappingObject.create([0], summary="clouds")]
+        mapping_obj = {"values": [0], "summary": "clouds"}
 
-        file_ext.values = values
+        # file_ext.values = values
+        file_ext.apply(values=[MappingObject.from_dict(mapping_obj)])
 
-        self.assertEqual(file_ext.values, values)
+        self.assertListEqual(asset.extra_fields["file:values"], [mapping_obj])
+
+        values_field = asset.extra_fields["file:values"]
+        self.assertIsInstance(values_field, list)
+        for mapping_obj in values_field:
+            self.assertIsInstance(mapping_obj, dict)
 
     def test_item_asset_apply(self) -> None:
         item = pystac.Item.from_file(self.FILE_ITEM_EXAMPLE_URI)
@@ -146,7 +152,8 @@ def test_item_asset_apply(self) -> None:
         new_checksum = "90e40210163700a8a6501eccd00b6d3b44ddaed0"
         new_size = 1
         new_header_size = 8192
-        new_values = [MappingObject.create([0], summary="clouds")]
+        new_mapping_obj = {"values": [0], "summary": "clouds"}
+        new_values = [MappingObject.from_dict(new_mapping_obj)]
         new_byte_order = ByteOrder.LITTLE_ENDIAN
 
         self.assertNotEqual(file_ext.checksum, new_checksum)
@@ -163,11 +170,11 @@ def test_item_asset_apply(self) -> None:
             values=new_values,
         )
 
-        self.assertEqual(file_ext.checksum, new_checksum)
-        self.assertEqual(file_ext.size, new_size)
-        self.assertEqual(file_ext.header_size, new_header_size)
-        self.assertEqual(file_ext.values, new_values)
-        self.assertEqual(file_ext.byte_order, new_byte_order)
+        self.assertEqual(asset.extra_fields["file:checksum"], new_checksum)
+        self.assertEqual(asset.extra_fields["file:size"], new_size)
+        self.assertEqual(asset.extra_fields["file:header_size"], new_header_size)
+        self.assertEqual(asset.extra_fields["file:values"], [new_mapping_obj])
+        self.assertEqual(asset.extra_fields["file:byte_order"], new_byte_order)
 
     def test_repr(self) -> None:
         item = pystac.Item.from_file(self.FILE_ITEM_EXAMPLE_URI)
diff --git a/tests/test_catalog.py b/tests/test_catalog.py
index a25cb8005..4b4425897 100644
--- a/tests/test_catalog.py
+++ b/tests/test_catalog.py
@@ -18,7 +18,13 @@
     HIERARCHICAL_LINKS,
 )
 from pystac.extensions.label import LabelClasses, LabelExtension, LabelType
-from pystac.utils import is_absolute_href, join_path_or_url, JoinType
+from pystac.utils import (
+    is_absolute_href,
+    join_path_or_url,
+    JoinType,
+    make_absolute_href,
+    make_relative_href,
+)
 from tests.utils import (
     TestCases,
     ARBITRARY_GEOM,
@@ -332,6 +338,63 @@ def test_save_to_provided_href(self) -> None:
             for link in result_cat.get_child_links():
                 self.assertTrue(cast(str, link.target).startswith(href))
 
+    def test_subcatalogs_saved_to_correct_path(self) -> None:
+        with tempfile.TemporaryDirectory() as tmp_dir:
+            catalog = TestCases.test_case_1()
+            href = "http://test.com"
+
+            catalog.normalize_hrefs(href)
+            catalog.save(catalog_type=CatalogType.ABSOLUTE_PUBLISHED, dest_href=tmp_dir)
+
+            # Check the root catalog path
+            expected_root_catalog_path = os.path.join(tmp_dir, "catalog.json")
+            self.assertTrue(
+                os.path.exists(expected_root_catalog_path),
+                msg=f"{expected_root_catalog_path} does not exist.",
+            )
+            self.assertTrue(
+                os.path.isfile(expected_root_catalog_path),
+                msg=f"{expected_root_catalog_path} is not a file.",
+            )
+
+            # Check each child catalog
+            for child_catalog in catalog.get_children():
+                relative_path = make_relative_href(
+                    child_catalog.self_href, catalog.self_href, start_is_dir=False
+                )
+                expected_child_path = make_absolute_href(
+                    relative_path,
+                    expected_root_catalog_path,
+                    start_is_dir=False,
+                )
+                self.assertTrue(
+                    os.path.exists(expected_child_path),
+                    msg=f"{expected_child_path} does not exist.",
+                )
+                self.assertTrue(
+                    os.path.isfile(expected_child_path),
+                    msg=f"{expected_child_path} is not a file.",
+                )
+
+            # Check each item
+            for item in catalog.get_all_items():
+                relative_path = make_relative_href(
+                    item.self_href, catalog.self_href, start_is_dir=False
+                )
+                expected_item_path = make_absolute_href(
+                    relative_path,
+                    expected_root_catalog_path,
+                    start_is_dir=False,
+                )
+                self.assertTrue(
+                    os.path.exists(expected_item_path),
+                    msg=f"{expected_item_path} does not exist.",
+                )
+                self.assertTrue(
+                    os.path.isfile(expected_item_path),
+                    msg=f"{expected_item_path} is not a file.",
+                )
+
     def test_clone_uses_previous_catalog_type(self) -> None:
         catalog = TestCases.test_case_1()
         assert catalog.catalog_type == CatalogType.SELF_CONTAINED
diff --git a/tests/test_utils.py b/tests/test_utils.py
index 4f6e1d849..453dc6fcd 100644
--- a/tests/test_utils.py
+++ b/tests/test_utils.py
@@ -158,6 +158,7 @@ def test_make_absolute_href(self) -> None:
                 "https://stacspec.org/a/b/c/catalog.json",
                 "https://stacspec.org/a/b/item.json",
             ),
+            ("http://localhost:8000", None, "http://localhost:8000"),
         ]
 
         for source_href, start_href, expected in test_cases: