How to document your solutions

This page gathers information about what documentation is needed for your Power Platform solutions.

General

So you have created a Power Platform solution and users are now using it in a production environment. In order to be able to maintain the solution over time it is important to establish and maintain documentation as well.

Examples of what documentation that is useful to have:

• Best Practice and naming conventions - Best to figure this out before you start with your project in order to establish a common way of working.
• Entity Relationship Diagram (ERD) visualizing the essential OOTB Tables that make up your solution as well as all custom tables and the relationships in between.
• Environments that are used and settings specific for each environment (that are not deployed through solutions, e.g. search settings or configuration data).
• ALM and deploy procedure - info about pipelines, the setup and who is responsible for deploys.
• Solution Components - Description of Tables, relationships in between, Business Rules, Business Process Flows (BPF), Cloud flows, Plugins etc.
• For Canvas Apps - Data Sources
• Integrations - What integrations there are, diagram illustrating integration flows, integration techniques, mappings.
• Functional description

If Azure DevOps is used, a Project Wiki can be used to store information about environments, settings and pipelines. If Microsoft Teams is used, a OneNote can be used as wiki.

Tools

There are some tools to be used as part of creating documentation for your solutions.

• XTB - ERD Visio Builder
• XTB - Flow to Visio
• XTB - Role Documenter
• XTB - Metadata Document Generator
• PVA to Visio Builder (In progress)