Coding
PromptBeginner5 minmarkdown
Nano Banana Pro
Agent skill for nano-banana-pro
6
This `docs` folder contains the Hugo static site for Azure DevOps Migration Tools documentation. The site is deployed to Azure Static Web Apps and relies on YAML/Markdown data generated by `src/MigrationTools.ConsoleDataGenerator`.
Sign in to like and favorite skills
docs (Hugo Site for Azure DevOps Migration Tools)This
docs folder contains the Hugo static site for Azure DevOps Migration Tools documentation. The site is deployed to Azure Static Web Apps and relies on YAML/Markdown data generated by src/MigrationTools.ConsoleDataGenerator.
This site includes a configuration wizard that guides users through setting up their migration configurations interactively. The wizard is designed to simplify the process of creating complex migration configurations by providing step-by-step instructions and examples. Its documentation is in config-wizard.md.
The
docs\content\docs directory contains the main documentation sections, including:
docs/data/reference/, and should be validated against the schema in docs\static\schema.content/, layouts in layouts/, static assets in static/, and data in data/.docs/ ├── _site-docs # Contains additional documentation about features in the site itself ├── content/ # Documentation content (Markdown with YAML front matter) │ ├── docs/ # Main documentation sections │ │ ├── get-started/ # Getting started guides │ │ ├── how-to/ # How-to guides and tutorials │ │ ├── reference/ # Reference documentation │ │ ├── setup/ # Setup and installation guides │ │ ├── config-wizard.md # Configuration wizard page │ │ └── _index.md # Documentation section index │ ├── download/ # Download pages and resources │ ├── support/ # Support and community pages │ ├── schema/ # JSON schema documentation │ ├── 404.md # Custom 404 error page │ └── _index.md # Site homepage ├── layouts/ # Hugo templates (HTML with Go templating - v0.146+ new system) │ ├── docs/ # Section-specific layouts for docs │ ├── _partials/ # Reusable template components (v0.146+ naming) │ │ ├── components/ # UI component partials │ │ ├── docs/ # Documentation-specific partials │ │ ├── functions/ # Template functions and utilities, they return HTML or data │ │ ├── JSON-LD/ # Structured data partials │ ├── _shortcodes/ # Custom Hugo shortcodes (v0.146+ naming) │ ├── _markup/ # Custom markup renderers │ ├── baseof.html # Base template for all pages │ ├── index.html # Homepage template │ ├── single.html # Single page template │ ├── list.html # List page template │ └── *.html # Other page-specific templates ├── static/ # Static assets (images, CSS, JS, PDFs) │ ├── images/ # Documentation images and diagrams │ ├── css/ # Custom stylesheets │ └── js/ # JavaScript files ├── data/ # Generated YAML/JSON data files │ ├── reference/ # Auto-generated reference docs │ └── samples/ # Configuration samples ├── hugo.yaml # Main Hugo configuration ├── hugo.local.yaml # Local development config ├── hugo.preview.yaml # Preview environment config ├── hugo.production.yaml # Production environment config ├── hugo.canary.yaml # Canary deployment config └── .hugo_build.lock # Hugo build lock file
/docs/_data/ generated by MigrationTools.ConsoleDataGenerator for configuration samples, processor options, and reference docs./docs/_data/; always regenerate using the ConsoleDataGenerator after code changes.data templates to render configuration samples and reference tables from YAML.GenerateDocs.ps1 script at the repo root for consistent doc generation.staticwebapp.config.json for SWA routing and configuration.