update

Author: SilverRainZ

docs/fw/api.rst docs/api.rstdocs/fw/api.rst renamed to docs/api.rst

@@ -1,6 +1,6 @@
-=====
-Usage
-=====
+=================================================
+Guide: Developing based on ``sphinxnotes.render``
+=================================================
 
 .. seealso::
 
@@ -17,7 +17,7 @@ Sphinx and inserted into the document.
 Now we have a quick example to help you get Started.
 Create a Sphinx documentation with the following ``conf.py``:
 
-.. literalinclude:: ../../tests/roots/test-ctxdir-usage/conf.py
+.. literalinclude:: ../tests/roots/test-ctxdir-usage/conf.py
 
 This is the smallest useful extension built on top of ``sphinxnotes.render``:
 

docs/app/conf.rst docs/conf.rstdocs/app/conf.rst renamed to docs/conf.rst

@@ -46,7 +46,7 @@ Getting Started
 .. note::
 
    In this section we discuss how to use the extension. For the usage of
-   the framework, please refer to :doc:`/fw/usage`.
+   the framework, please refer to :doc:`dev`.
 
 .. note::
 
@@ -147,20 +147,20 @@ Contents
 
 .. toctree::
    :caption: Extension
+   :maxdepth: 1
 
-   app/usage
-   app/tmpl
-   app/conf
+   usage
+   conf
 
 .. toctree::
    :caption: Framework
-   :maxdepth: 2
+   :maxdepth: 1
 
-   fw/usage
-   fw/tmpl
-   fw/ext
-   fw/dsl
-   fw/api
+   tmpl
+   ext
+   dev
+   dsl
+   api
 
 The Sphinx Notes Project
 ========================

docs/fw/usage.rst docs/dev.rstdocs/fw/usage.rst renamed to docs/dev.rst

@@ -29,11 +29,13 @@ For ``sphinxnotes.render.ext``, you can use :rst:dir:`data.template` or
 
 
 What Data is Available
-=======================
+======================
 
 Your template receives data from two sources: **main context** and **extra
 context**.
 
+.. _context:
+
 Main Context
 ------------
 
@@ -410,12 +412,13 @@ Enable the debug option to see a detailed report when troubleshooting templates:
 This is especially useful when a template fails due to an undefined variable,
 unexpected data shape, or invalid generated markup.
 
-Jinja Template Technical Details
-================================
+Some Technical Details
+======================
+
+Jinja Template 
+--------------
 
 Templates are rendered in a sandboxed Jinja2 environment.
 
 - Undefined variables raise errors by default (``undefined=DebugUndefined``)
 - Extension ``jinja2.ext.loopcontrols``, ``jinja2.ext.do`` are enabled by default.
-- Output is plain markup text, so you can generate lists, directives, roles,
-  and other reStructuredText constructs.