Documentation Index

Fetch the complete documentation index at: https://docs.turbo360.com/llms.txt

Use this file to discover all available pages before exploring further.

Creating your first document

  • 4 minute(s) read
Prev Next

Overview

This tutorial walks you through creating your first document configuration in Azure Documenter and generating a document from it. By the end, you will have a saved configuration and a generated document published to your chosen destination.

Business value

Completing this tutorial gives you a working document configuration you can reuse, schedule, or duplicate as a template for other document types. It also confirms that your Service principal has the correct access to your Azure subscriptions before you build out a broader reporting library.

Prerequisites

  • A Turbo360 account with access to Azure Documenter
  • A Service principal configured in Azure Documenter with Reader access to at least one Azure subscription. See Service principal setup{target=_blank}.
  • At least one Azure subscription accessible through the Service principal

Required permissions

Role Access
Account owner, Owner, Contributor Full access by default
Custom role Requires the Documentation permission set to Manage

Steps

This tutorial takes you from the document configurations list to a generated document. Navigate to Azure Documenter in Turbo360 to get started.

Step 1: Open the Add configuration wizard

Opening the wizard starts the 7-step process that captures all the settings Azure Documenter needs to generate your document.

  1. In the document configurations list, click + New configuration. The Add configuration wizard opens at the Basics step.

Step 2: Set up the Basics

The Basics step defines the configuration name, description, and document type — the settings that identify this configuration and determine what Azure Documenter generates.

  1. Enter a Name for the configuration. Use a name that reflects the document type and subscription scope — for example, Executive summary – Production.
  2. Optionally enter a Description to record the configuration's purpose or intended audience.
  3. Under Choose document type, select the document type for this configuration. Use the category filter tabs (Executive, Finance, Security, Operations, Architecture, Sustainability, Microsoft 365) or the search field to find a type.
  4. Configure any document-type-specific options that appear — for example, billing range and currency for cost-related types.
  5. Click Next.

Step 3: Configure the Service principal scope

The Service principal step defines which Azure subscriptions Azure Documenter accesses to generate the document.

  1. Select the Service principal that has Reader access to the subscriptions you want to include.
  2. Select the subscriptions to include. Use Bulk scope selection to filter and assign multiple subscriptions at once.
  3. Click Next.

Step 4: Set branding

The Branding step controls the visual appearance of the document cover page.

  1. Set an Accent colour for the document cover page and accent elements. The default is #2b6cb0.
  2. Optionally upload a Logo (PNG, JPG, SVG, or ICO; max 100 KB) to appear on the cover page.
  3. Click Next.

Step 5: Configure publish settings

The Publish settings step determines where the generated document is delivered.

  1. Choose a publish destination:
    • Publish document to Azure Storage account — delivers the document as PDF, Word, or Excel to an Azure Storage account.
    • Publish document to Document360 — publishes the document as a PDF directly to a Document360 knowledge base.
  2. Configure the destination details for the option you selected.
  3. Click Next.

Step 6: Skip schedule and notifications for now

For your first document, proceed through the remaining steps without enabling a schedule or adding notification recipients — you will generate immediately from the Review step.

  1. Click Next on the Schedule step without enabling a schedule.
  2. Click Next on the Notifications step without adding recipients.

Step 7: Review and generate

The Review step displays a summary of all settings — confirm everything is correct before generating.

  1. Review the configuration summary. Verify the document type, Service principal, subscriptions, and publish destination.
  2. Click Preview document to inspect the document content and layout before committing to a full generation. Close the preview when done.
  3. Click Generate to save the configuration and generate the document immediately.

Azure Documenter saves the configuration and begins generation. When generation completes, the document is published to your configured destination.

Troubleshooting

  1. + New configuration is not available
    Cause: your role has only Read access to the Documentation feature, or you do not have a built-in Account owner, Owner, or Contributor role.
    Fix: ask an Account owner to set Manage access on the Documentation feature for your custom role. See Managing document configurations{target=_blank}.

  2. No subscriptions appear in the Service principal step
    Cause: the selected Service principal does not have Reader access to any Azure subscription, or no subscriptions are associated with the Service principal's tenant.
    Fix: verify the Service principal has Reader access at the subscription level in the Azure portal, then return to the wizard and reselect the Service principal. See Service principal setup{target=_blank}.

  3. The generated document is empty or has missing sections
    Cause: the Service principal does not have Reader access to one or more of the configured subscriptions. Azure Documenter generates with what it can access and silently omits the rest.
    Fix: verify Reader access on every configured subscription in the Azure portal, then regenerate. See Service principal permission errors{target=_blank}.

  4. Generation completes but the document does not appear in the Azure Storage account
    Cause: the storage account connection in the Publish settings step is misconfigured, or the storage account has been deleted or moved since the configuration was saved.
    Fix: edit the configuration, navigate to the Publish settings step, and verify the Azure Storage account destination. See Document generation failures{target=_blank}.

Related articles