davidfowl

Documentation Gap Issues - Summary

Overview

Issues to file for documentation gaps identified by analyzing what's-new docs vs standalone reference documentation.

---

Features WITH Docs (No Issue Needed)

davidfowl

Documentation Gaps Summary - GitHub Discussions Analysis

Method

Analyzed 820 GitHub discussions from dotnet/aspire using:

1. Fetch all discussions via gh api graphql
2. Categorize by topic (deployment, testing, integrations, etc.)
3. Verify docs answer specific questions using aspire-get_doc - not just that docs exist

Key Insight

davidfowl

[Discord Feedback] App Model API gaps - CORS, console apps, naming, networking

Summary

Based on analysis of 20,415 Discord messages + 147 #help threads from the Aspire community (April 2025 - February 2026), several App Model API features lack documentation.

Missing Documentation

1. CORS Configuration (10+ questions)

davidfowl

Aspire Bundle Size Analysis - Team Summary

Date: January 2025
Current Bundle Size (Windows x64): 577 MB on disk, 204 MB compressed

Executive Summary

Component	Size	#1 Bloat Source	Top Recommendation	Potential Savings
DCP	286 MB	5 large Go binaries (50-65 MB each)	UPX compression	80-140 MB

davidfowl

Bug Reproduction Documentation - Overview & Format

Mission & Context

You are conducting production-grade bug reproduction and analysis for the Aspire project. This is not a casual bug verification exercise - your output will be used by:

1. Engineering teams to understand and fix bugs
2. Technical writers to create bug reports and documentation
3. QA teams to verify fixes
4. Community contributors who need clear reproduction steps

davidfowl

Aspire Discussions Deep Analysis - Results Summary

Gist: https://gist.github.com/davidfowl/fde2a3f5a7179ccf6049cde9e97a5ca0

Analysis Complete! ✅

Reprocessed 200 unanswered Q&A discussions with deep source code analysis and test-first approach.

Results Overview

davidfowl

{
  "analyzed_at": "2026-01-17T22:02:29.875944Z",
  "scope": "200 most recent unanswered Q&A discussions",
  "total_discussions": 200,
  "unique_discussions": 172,
  "duplicate_discussions": 28,
  "discussions": [
    {
      "discussion_number": 13976,

davidfowl

Aspire + Java Integration Proposal

See 2024 JetBrains Java Developer Survey and Spring Boot Statistics for context on the Java ecosystem.

Note: The Community Toolkit provides Java/Spring Boot hosting. Aspire 13 elevated Python and JavaScript to first-class citizens with polyglot connection properties including JDBC format. This proposal outlines bringing Java to the same first-class status.

Executive Summary

Java is the second most popular enterprise language after JavaScript/TypeScript, with Spring Boot dominating the web framework space (~70% of Java web applications). With Aspire 13's rebrand from ".NET Aspire" to "Aspire" and first-class Python/JavaScript support, Java is the natural next step. This document outlines a Spring Boot-centric approach while maintaining flexibility for other Java frameworks.

davidfowl

#pragma warning disable ASPIREINTERACTION001 // Type is for evaluation purposes only and is subject to change or removal in future updates. Suppress this diagnostic to proceed.

using System.Text.Json;
using System.Text.Json.Nodes;
using Microsoft.Extensions.DependencyInjection;

namespace Aspire.Hosting
{
    public static class ResourceBuilderProjectExtensions
    {

davidfowl

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
using Microsoft.Extensions.Logging;
using System.IO;

namespace Aspire.Hosting;

public static class DevCertHostingExtensions
{
    /// <summary>