Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Oct 10, 2025

Overview

This PR implements a community reports repository for Power BI reports, following the Azure Quickstart Templates model. This enables the FinOps community to share specialized Power BI reports for specific use cases while maintaining clear separation from official toolkit reports.

Problem Statement

The FinOps toolkit needed a way for community members to contribute and share Power BI reports without requiring formal support from the toolkit team. Similar to Azure Quickstart Templates, contributors should own and maintain their reports, with clear differentiation from officially supported toolkit reports.

Solution

Created a comprehensive community reports structure under src/power-bi/community/ with:

1. Repository Structure

  • Main README (216 lines) - Comprehensive contribution guidelines covering:

    • Folder structure requirements
    • Documentation standards
    • Quality and testing requirements
    • Validation checklist
    • Support model ("AS IS", no formal SLA)
  • Template folder (.template/) - Ready-to-use templates for new contributions:

    • README template with placeholders for all required sections
    • CONTRIBUTORS template for maintainer information
    • INFO guide with instructions for using templates

2. Documentation Integration

  • Microsoft Learn page (docs-mslearn/toolkit/power-bi/community.md) - Full documentation for discovering and using community reports
  • Updated existing docs - Integrated references in Power BI reports documentation and public website
  • Changelog entry - Documented new feature in v13 release

3. Contribution Infrastructure

  • GitHub issue template (.github/ISSUE_TEMPLATE/community-report.md) - Streamlined submission process with pre-submission checklist and review guidelines

Key Differentiators

Community reports are clearly distinguished from official toolkit reports:

Aspect Official Reports Community Reports
Maintenance FinOps toolkit team Community contributors
Support Microsoft channels Contact maintainer (no formal support)
Quality Full QA by team Community review, best effort
Updates Regular with releases By report owner
Branding FinOps toolkit Community contributor

How It Works

For Contributors

  1. Copy the .template/ folder to a new directory under community/
  2. Fill in README and CONTRIBUTORS templates with report details
  3. Add Power BI report files (.pbip, .pbit, or .pbix)
  4. Include screenshots demonstrating key features
  5. Submit PR using the community-report issue template

For Users

  1. Browse the community/ directory for available reports
  2. Review report README for setup instructions and prerequisites
  3. Download and configure report per documentation
  4. Contact report maintainer (not toolkit team) for support

Authoritative Sources

This implementation references established patterns and standards:

Testing

  • ✅ Directory structure validated
  • ✅ Template files include comprehensive guidance
  • ✅ Documentation cross-references verified
  • ✅ Links to referenced files confirmed (CONTRIBUTING.md, LICENSE, etc.)
  • ✅ Code review completed with no issues

Impact

This enables the FinOps community to:

  • Share specialized reports for specific industries or scenarios
  • Accelerate onboarding without requiring formal toolkit support
  • Contribute solutions for edge cases not covered by official reports
  • Build on each other's work while maintaining clear ownership

The repository is immediately ready for community contributions with clear templates, guidelines, and expectations.


Fixes #[issue-number]

Original prompt

This section details on the original issue you should resolve

<issue_title>Repository for community reports and dashboards</issue_title>
<issue_description>### Are you submitting your tool or someone else's?

I'm submitting a suggestion for someone else's tool (please specify below).

Tool ownership responsibilities (only applicable to tool owners)

  • I acknowledge the responsibilities of a technical lead and agree to serve in this role for the proposed tool upon its approval.

Tool name

Community reports

Description

Create a repository for the FinOps community to share Power BI reports that they own and maintain. Contributed reports would not be maintained by the FinOps toolkit. The repository would work similar to the Azure Quickstart Templates repository. Owners own their reports and the toolkit makes no statement about the level of support or maintenance of them. The goal is to accelerate onboarding for simple reports that may not be owned by us. This could be hosted in the FTK rep or possibly just a reference to other GitHub repositories.

Use case

Reporting and analytics primarily, but this could be extended to many scenarios.

Services used

Power BI, Data Explorer, Fabric

Dependencies

Community contributions</issue_description>

<agent_instructions>Triage the issue, research using mslearn, provide proposed solutions along with links/citations to authorative sources.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@flanakin > I like the idea, but I would only suggest to implement it, if we can somehow guarantee, that the reports will work, which is a big challenge based on the fast moving FTK target.

Agreed. I'm wondering how we can differentiate community reports from sponsored reports. We won't be able to guarantee everything. This would be similar to Azure Quickstart Templates.</comment_new>

Fixes #1583


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@Copilot Copilot AI changed the title [WIP] Create repository for community Power BI reports Add community reports repository for Power BI reports Oct 10, 2025
Copilot finished work on behalf of MSBrett October 10, 2025 20:46
@Copilot Copilot AI requested a review from MSBrett October 10, 2025 20:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Review 👀 PR that is ready to be reviewed Skill: DevOps GitHub setup and automation Skill: Documentation Documentation updates Tool: FinOps guide Implementing FinOps guide

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Repository for community reports and dashboards

5 participants