Add comprehensive web-app integration documentation based on workspace.yaml configuration

[Copilot]

Overview

This PR adds comprehensive documentation for web application integration using the workspace.yaml configuration file. The new documentation provides detailed guidance on configuring and deploying web-app integrations with Power BI, ADX, and Event Hub services.

What's New

New Documentation: Web App Integration with workspace.yaml

Created a detailed guide (webapp-integration.md) that covers:

Configuration Structure

• Complete breakdown of workspace.yaml file structure
• Basic configuration (workspace key, name, description)
• Power BI workspace and report configuration with connection parameters
• ADX (Azure Data Explorer) database initialization and script setup
• Event Hub connectors for streaming simulation data
• Web app options including dynamic filters and parameters

Practical Examples

• Multi-site configuration patterns
• Time-based analytics setup
• Multi-report dashboard configurations
• Complete working workspace.yaml template

Deployment & Integration

• Step-by-step deployment workflow using Babylon
• Configuration checklist for validation
• Integration workflow from variables.yaml to deployed web-app

Troubleshooting & Best Practices

• Common issues and solutions (reports not appearing, ADX connection errors, dynamic filters, Event Hub data flow)
• Configuration management best practices
• Performance optimization guidelines
• Security recommendations

Files Changed

1. Tutorial/docs/tutorials/web-app/webapp-integration.md (NEW)

   • 416 lines of comprehensive documentation
   • 9 main sections with 17 subsections
   • 15 code examples and configuration snippets

2. Tutorial/docs/tutorials/web-app/.nav.yml (UPDATED)

   • Added "Web App Integration" navigation entry

3. Tutorial/docs/tutorials/web-app/index.md (UPDATED)

   • Added card for new integration documentation

Benefits

• Users now have a single, comprehensive resource for understanding workspace.yaml configuration
• Clear explanation of how workspace.yaml drives web-app integration
• Practical examples reduce configuration errors
• Troubleshooting guide helps resolve common deployment issues
• Better understanding of the relationship between Power BI, ADX, Event Hub, and the web application

Documentation Preview

The new documentation includes sections on:

# Example: Power BI Configuration
sidecars:
  azure:
    powerbi:
      workspace:
        reports:
          - name: Example
            displayName: "Analytics Dashboard"
            parameters:
              ADX_Cluster: https://mycluster.region.kusto.windows.net
              ADX_Database: MyDatabase

Cross-references to related documentation:

• Power BI Overview
• ADX Database
• Frontend Architecture
• Hands-On Discovery Guide

Testing

• ✅ YAML syntax validation passed
• ✅ Markdown front matter validated
• ✅ All internal links verified
• ✅ Navigation structure confirmed
• ✅ No security vulnerabilities detected

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• fonts.google.com
  • Triggering command: /usr/bin/python3 /home/REDACTED/.local/bin/mkdocs build --strict (dns block)
  • Triggering command: /usr/bin/python3 /home/REDACTED/.local/bin/mkdocs build (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

more info o web-app for webapp integration based on the config from workspace.yaml file

---

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