diff --git a/docs/source/1.0/guides/building-models/build-config.rst b/docs/source/1.0/guides/building-models/build-config.rst index 4e6605ea24d..06604faf84b 100644 --- a/docs/source/1.0/guides/building-models/build-config.rst +++ b/docs/source/1.0/guides/building-models/build-config.rst @@ -147,7 +147,7 @@ A projection accepts the following configuration: - Defines the plugins to apply to the model when building this projection. Plugins are a mapping of plugin names to an arbitrary plugin configuration object. smithy-build will attempt to resolve - plugin names using `Java SPI`_ to locate and instance of ``software.amazon.smithy.build.SmithyBuildPlugin`` + plugin names using `Java SPI`_ to locate an instance of ``software.amazon.smithy.build.SmithyBuildPlugin`` that returns a matching name when calling ``getName``. smithy-build will emit a warning when a plugin cannot be resolved. diff --git a/docs/source/quickstart.rst b/docs/source/quickstart.rst index d735b04aed1..dfee53d22c7 100644 --- a/docs/source/quickstart.rst +++ b/docs/source/quickstart.rst @@ -295,11 +295,12 @@ resource. Defining operations =================== -The ``create``, ``read``, ``update``, ``delete``, and ``list`` properties of a -resource are used to define the :ref:`lifecycle operations ` -of a resource. Lifecycle operations are the canonical methods used to read and -transition the state of a resource using well-defined semantics. Defining -lifecycle operations helps automated tooling reason about your API. +The ``put``, ``create``, ``read``, ``update``, ``delete``, and ``list`` +properties of a resource are used to define the :ref:`lifecycle operations +` of a resource. Lifecycle operations are the canonical +methods used to read and transition the state of a resource using well-defined +semantics. Defining lifecycle operations helps automated tooling reason about +your API. Let's define the operation used to "read" a ``City``.