chore: Some tweaks

Author: SilverRainZ

docs/api.rst

@@ -83,22 +83,20 @@ See :doc:`tmpl` for built-in extra-context names such as ``doc`` and
 
 .. autofunction:: sphinxnotes.render.extra_context
 
-.. autoclass:: sphinxnotes.render.ExtraContext
-
 .. autoclass:: sphinxnotes.render.ParsingPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.ParsedPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.ResolvingPhaseExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 .. autoclass:: sphinxnotes.render.GlobalExtraContext
-   :members: generate
+   :members: phase, generate
    :undoc-members:
 
 Base Roles and Directives

docs/tmpl.rst

@@ -154,46 +154,56 @@ Extra Context
 -------------
 
 Templates can access additional context through **extra context**. Extra context
-must be explicitly declared using the ``:extra:`` option and loaded in the
+must be explicitly declared using the :rst:dir:`templat:extra` option and loaded in the
 template using the ``load_extra()`` function.
 
-Built-in extra context
-......................
-
-.. list-table::
-   :header-rows: 1
-
-   * - Name
-     - Available in Pahses
-     - Description
-   * - ``sphinx``
-     - all
-     - A proxy to the Sphinx application object.
-   * - ``docutils``
-     - all
-     - A mapping that exposes registered docutils directives and roles.
-   * - ``markup``
-     - :term:`parsing` and later
-     - Information about the current directive or role invocation, such as its
-       type, name, source text, and line number.
-   * - ``section``
-     - :term:`parsing` and later
-     - A proxy to the current section node, when one exists.
-   * - ``doc``
-     - :term:`parsing` and later
-     - A proxy to the current document node.
-
-These values are wrapped for safer template access. In practice this means
-templates can read public, non-callable attributes, but should not rely on
-arbitrary Python object behavior.
+Built-in Extra Contexts
+~~~~~~~~~~~~~~~~~~~~~~~
+
+``sphinx``
+..........
+
+:Phase: all
+
+A proxy to the :py:class:`sphinx.application.Sphinx` object.
+
+``env``
+.......
+
+:Phase: all
+
+A proxy to the :py:class:`sphinx.environment.BuildEnvironment` object.
+
+``markup``
+..........
+
+:Phase: :term:`parsing` and later
+
+Information about the current directive or role invocation, such as its
+type, name, source text, and line number.
+
+``section``
+............
+
+:Phase: :term:`parsing` and later
+
+A proxy to the current :py:class:`docutils.nodes.section` node, when one exists.
+
+``doc``
+.......
+
+:Phase: :term:`parsing` and later
+
+A proxy to the current :py:class:`docutils.notes.document` node.
 
 .. example::
    :style: grid
 
    .. data.render::
       :extra: doc
 
-      Current document title is
+
+      Title of current document is
       "{{ load_extra('doc').title }}".
 
 Extending extra context
@@ -237,16 +247,16 @@ Each :py:class:`~sphinxnotes.render.Template` has a render phase controlled by
 
          .. data.render::
             :on: parsing
-            :extra: doc sphinx
+            :extra: doc env
 
             {% set doc = load_extra('doc') %}
-            {% set sphinx = load_extra('sphinx') %}
+            {% set env = load_extra('env') %}
 
             - The current document has
               {{ doc.sections | length }}
               section(s).
             - The current project has
-              {{ sphinx.env.all_docs | length }}
+              {{ env.all_docs | length }}
               document(s).
 
    ``parsed``
@@ -261,41 +271,41 @@ Each :py:class:`~sphinxnotes.render.Template` has a render phase controlled by
 
          .. data.render::
             :on: parsed
-            :extra: doc sphinx
+            :extra: doc env
 
             {% set doc = load_extra('doc') %}
-            {% set sphinx = load_extra('sphinx') %}
+            {% set env = load_extra('env') %}
 
             - The current document has
               {{ doc.sections | length }}
               section(s).
             - The current project has
-              {{ sphinx.env.all_docs | length }}
+              {{ env.all_docs | length }}
               document(s).
 
    ``resolving``
       Corresponding to :py:data:`sphinxnotes.render.Phase.Resolving`.
       Render late in the build, after references and other transforms are being
       resolved.
 
-      Choose this when the template depends on project-wide state or on document
+      Choose this when the template depends on pr
       structure that is only stable near the end of the pipeline.
 
       .. example::
          :style: grid
 
          .. data.render::
             :on: resolving
-            :extra: doc sphinx
+            :extra: doc env
 
             {% set doc = load_extra('doc') %}
-            {% set sphinx = load_extra('sphinx') %}
+            {% set env = load_extra('env') %}
 
             - The current document has
               {{ doc.sections | length }}
               section(s).
             - The current project has
-              {{ sphinx.env.all_docs | length }}
+              {{ env.all_docs | length }}
               document(s).
 
 Debugging
@@ -343,3 +353,9 @@ This pattern is often the most convenient way to build small, declarative
 directives. For more control, subclass
 :py:class:`~sphinxnotes.render.BaseDataDefineDirective` directly and implement
 ``current_schema()`` and ``current_template()`` yourself.
+   .. data.render::
+      :extra: doc
+
+
+      Title of current document is
+      "{{ load_extra('doc').title }}".