docs: add graphviz examples across documentation

Add rich graphviz diagrams to documentation pages:
- 10min.rst - intro visualization example
- visualization/10min.rst - layout pipeline diagram
- ecosystem.rst - ecosystem overview
- gfql/overview.rst - GFQL flow diagram
- gfql/quick.rst - quick start example
- graphistry.layout.rst - layout options

Builds on infrastructure from base PR #859.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: lmeyerov

docs/source/10min.rst

@@ -202,8 +202,38 @@ For example, GraphViz layouts is known for its high quality for laying out small
 .. code-block:: python
 
     # pygraphistry handles format conversions behind-the-scenes
-    g2 = g1.layout_graphviz('dot')
-    g2.plot()
+   g2 = g1.layout_graphviz('dot')
+   g2.plot()
+
+Static Graphviz render
+----------------------
+
+When you need a quick static image (e.g., docs/notebooks), reuse the Graphviz layout. ``plot_static`` returns bytes you can embed or save:
+
+.. code-block:: python
+
+   # Reuse bound x/y if present; otherwise Graphviz lays out the graph
+   svg = g1.plot_static(format='svg', max_nodes=200, max_edges=400)
+   from IPython.display import SVG
+   SVG(svg)
+
+.. graphviz::
+
+   digraph quickstart_static {
+      rankdir=LR;
+      0 -> 1 -> 2 -> 3 -> 4;
+      0 [shape=box, style=filled, fillcolor=lightgray];
+   }
+
+DOT / Mermaid text (layout later)
+---------------------------------
+
+If you only need the text form, emit DOT or Mermaid DSL:
+
+.. code-block:: python
+
+   dot_text = g1.plot_static(engine='graphviz-dot', reuse_layout=True)
+   mermaid_text = g1.plot_static(engine='mermaid-code', reuse_layout=False)
 
 Using UMAP for Dimensionality Reduction
 ---------------------------------------
@@ -304,4 +334,4 @@ External Resources
 - `Graphistry REST API <https://hub.graphistry.com/docs/api/>`_: Work from any language
 - `Graphistry URL settings <https://hub.graphistry.com/docs/api/1/rest/url/#urloptions>`_: Control visualizations via URL parameters`
 
-Happy graphing!
+Happy graphing!

docs/source/ecosystem.rst

@@ -3,6 +3,17 @@ Graphistry Ecosystem and Louie.AI
 
 The Graphistry community of projects, open source, and partners has grown over the years:
 
+.. graphviz::
+
+   digraph graphistry_ecosystem_toy {
+       rankdir=LR;
+       data [label="Dataframes", shape=box, style=filled, fillcolor=lightgray];
+       gfql [label="GFQL"];
+       viz [label="Graphistry Viz"];
+       ai [label="Louie.AI"];
+       data -> gfql -> viz -> ai;
+   }
+
 Graphistry Core
 ---------------
 
@@ -78,4 +89,3 @@ Graphistry works with a variety of partners and projects, some of which include:
 * `Pandas <https://pandas.pydata.org/>`_
 * `Dask <https://www.dask.org/>`_
 
-

docs/source/gfql/overview.rst

@@ -10,6 +10,16 @@ Why GFQL?
 
 GFQL addresses a critical gap in the data community by providing an in-process graph query language that operates at the compute tier. This means you can:
 
+- **Tiny reachability map**:
+
+  .. graphviz::
+
+     digraph gfql_overview_toy {
+         rankdir=LR;
+         a -> b -> c -> d;
+         a [shape=box, style=filled, fillcolor=lightblue];
+     }
+
 - **Graph search**: Easily and efficiently query and filter nodes and edges using a familiar syntax.
 - **Avoid External Infrastructure**: Avoid calls to external infrastructures and eliminate the need for extra databases.
 - **Leverage Existing Workflows**: Integrate with your current Python data science tools and libraries.
@@ -328,4 +338,3 @@ Access detailed documentation of GFQL's API:
 - **Predicates**: Apply advanced filtering using predicates.
 
   - :doc:`../api/gfql/predicates`
-

docs/source/gfql/quick.rst

@@ -10,6 +10,14 @@ Basic Usage
 
 **Chaining Operations**
 
+.. graphviz::
+
+   digraph gfql_quick_toy {
+       rankdir=LR;
+       a -> b -> c -> d;
+       a [shape=box, style=filled, fillcolor=lightblue];
+   }
+
 .. code-block:: python
 
     g.gfql(ops=[...], engine=EngineAbstract.AUTO)

docs/source/graphistry.layout.rst

@@ -1,6 +1,16 @@
 graphistry.layout package
 =========================
 
+.. graphviz::
+
+   digraph layout_toy {
+       rankdir=LR;
+       data [label="Data (nodes/edges)"];
+       layout [label="Layout (x,y)"];
+       render [label="Render (Graphviz/Graphistry)"];
+       data -> layout -> render;
+   }
+
 Subpackages
 -----------
 

docs/source/visualization/10min.rst

@@ -113,6 +113,35 @@ PyGraphistry's :ref:`Layout catalog <layout-catalog>` provides many options, cov
   - :ref:`cuGraph <cugraph>` for GPU-accelerated FA2, a weaker version of Graphistry's live layout
   - :ref:`igraph <igraph>` for CPU-based layouts, similar to GraphViz and with layouts that focus more on medium-sized social networks
 
+Static Graphviz render (for docs/notebooks)
+-------------------------------------------
+
+When you need a quick static image without an interactive client, render directly with Graphviz. ``plot_static`` emits bytes that you can save or embed inline:
+
+.. code-block:: python
+
+   svg = g.plot_static(format='svg', max_nodes=200, max_edges=400)
+   from IPython.display import SVG
+   SVG(svg)
+
+.. graphviz::
+
+   digraph viz_static_demo {
+      rankdir=LR;
+      a -> b -> c -> d;
+      a [shape=box, style=filled, fillcolor=lightyellow];
+   }
+
+Text-only outputs
+-----------------
+
+Emit DOT or Mermaid DSL for downstream rendering or embedding:
+
+.. code-block:: python
+
+   dot_text = g.plot_static(engine='graphviz-dot', reuse_layout=True)
+   mermaid_text = g.plot_static(engine='mermaid-code', reuse_layout=False)
+
 - **External Layouts**: Pass in `x`, `y` columns, such as from your own edits, external data, or external ML/AI packages:
 
    .. code-block:: python