Plan a new developer guide section for an Exasol feature, connector, or tool. Searches docs.exasol.com, github.com/exasol, and PyPI for content, asks clarifying questions, then produces a structured plan ready for /exasol-developer-guide:implement. Usage: /exasol-developer-guide:new [feature or topic name]
git rev-parse --show-toplevel — do not use hardcoded paths<project-root>/doc/.rst) rendered by Sphinxdoc/connect_to_exasol/ (connectors) and doc/gen_ai/ai_text_summary/ (tutorials)If the user provided a feature/topic name as an argument, use it. If not, ask:
"What feature, connector, or tool do you want to document?"
Use WebSearch and WebFetch to gather information from all of the following:
site:docs.exasol.com [topic] — official Exasol documentationsite:github.com/exasol [topic] — Exasol GitHub repositoriessite:pypi.org [topic] exasol — Python packages (if applicable)[topic] exasol tutorial getting started[topic] exasol exampleFetch the most relevant pages found. Extract:
Detect the project root:
git rev-parse --show-toplevel
Then read the following (relative to that root) to ensure the new section fits project conventions:
doc/index.rst — current top-level toctree structuredoc/connect_to_exasol/index.rst and one content file from itdoc/gen_ai/ai_text_summary/index.rstBefore sketching the plan, ask:
doc/ or a subsection of an existing one?Wait for responses before sketching the plan.
doc/[section-folder-name]/
├── index.rst — Section landing page with toctree
├── overview.rst — What: definition, key concepts, system requirements
├── installation.rst — (if applicable) setup, dependencies, pip commands
├── [descriptive].rst — How: step-by-step with working code examples
└── [examples].rst — Real-world use cases and complete end-to-end examples
Adjust files based on complexity and content type.
For each file state:
State exactly:
doc/index.rst to insert the new entry [folder]/index)Note any :ref: links to/from existing sections that should be added.
Do NOT write any files. This skill produces a plan only.
The user will run /exasol-developer-guide:implement to write the files once the plan is approved.