update dev page

Author: hamelsmu

docs/get-started/dev-prepare.qmd

@@ -76,22 +76,51 @@ assert auto.members == auto_from_yml.members
 print(auto)
 ```
 
-Understanding how `Auto` an object created is helpful in case you need to debug `quartodoc`.  If you find that a configuration option is not being set as you expect, you can create an `Auto` object for the Python object in question and compare it to the `Auto` object that you expect to be created from your yaml configuration.
+Understanding the `Auto` object is helpful for debugging `quartodoc`.  If you find that a configuration option is not being set as you expect, you can create an `Auto` object for the Python object in question and compare it to the `Auto` object that you expect to be created from your yaml configuration.
 
-## Blueprint: create a renderable doc recipe
+## `blueprint`: Parse Metadata From Objects
 
-### From Auto
+`blueprint` parses all of the metadata about the python object and stores it in a hierarchal tree structure that is convenient for a renderer to transform into a renderable format like HTML or Markdown.  For example, here is the blueprint for the `MdRenderer` class:
 
 ```{python}
 from quartodoc import blueprint
 doc = blueprint(auto)
-doc
+preview(doc, max_depth=2)
 ```
 
+To give you a sense of this tree structure, we can look at the `obj.docstring` field of the above blueprint, which contains information about the [Python docstring](https://peps.python.org/pep-0257/):
+
 ```{python}
 preview(doc.obj.docstring, max_depth=2)
 ```
 
+We can see from this output that the parser for the docstring is `numpy`, which means the docstring is expected to be in the [numpy style](https://numpydoc.readthedocs.io/en/latest/format.html). 
+
+Furthermore, we can see from the tree structure that the `DocstringSectionText` is stored as the first element in a list under the `parsed` attribute:
+
+```{python}
+preview(doc.obj.docstring.parsed[0])
+```
+
+`DocstringSectionText` stores the "text" field of a [numpy style](https://numpydoc.readthedocs.io/en/latest/format.html) docstring, which is the first line of the docstring, which is otherwise known as the [short summary](https://numpydoc.readthedocs.io/en/latest/format.html#short-summary).
+Furthermore, we can see from the output above that the actual text of this short summary is stored in the `value` attribute:
+
+```{python}
+docstr_firstln_value = doc.obj.docstring.parsed[0].value
+print(docstr_firstln_value)
+```
+
+We can check the docstring of `MdRenderer` to see that this is indeed the first line of the docstring:
+
+```{python}
+from inspect import getdoc
+docstr_firstln = getdoc(MdRenderer).splitlines()[0]
+
+# These are the same
+assert docstr_firstln == docstr_firstln_value
+print(docstr_firstln)
+```
+
 ### Layout and Section
 
 ```{python}