chore(docs): clarify docs build call and graphviz render note

Author: lmeyerov

docs/README.md

@@ -13,7 +13,9 @@ It is volume-mounted to emit `docs/_build/html/index.html`
 For generating all types used in production, e.g., epub and pdf as well, mimic the CI runner:
 
 ```bash
-docs $ ./ci.sh
+ docs $ ./ci.sh
+ # or from repo root with an explicit format:
+ DOCS_FORMAT=html ./docs/ci.sh
 ```
 
 ## Architecture
@@ -71,4 +73,3 @@ Notebook validation is enabled by default. To disable: `VALIDATE_NOTEBOOK_EXECUT
 - Rerun `cd docs && ./ci.sh` to see the changes, with the benefit of docker & sphinx incremental builds
 
 - Check your results in `docs/_build/html/index.html` or the equivalent epub and pdf files
-

graphistry/plugins/graphviz.py

@@ -334,6 +334,9 @@ def render_graphviz(
     This wraps :func:`layout_graphviz_core` to compute positions, then draws with pygraphviz.
     Optionally enforces caps to keep renders small/deterministic for docs/examples.
 
+    When ``include_positions`` is True and the plot has bound x/y values, the existing layout
+    is preserved rather than recomputed by Graphviz.
+
     :param self: Base graph
     :type self: Plottable
     :param prog: Layout algorithm