From 0dc4cf442fce22131b9a204d3a381819984123db Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Thu, 23 Jul 2026 13:19:21 -0500 Subject: [PATCH 1/3] Clarify third-party link guidelines Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f983d401-1730-48ef-a79a-8d398376fcd3 --- .../src/content/docs/community/contributor-guide.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/src/frontend/src/content/docs/community/contributor-guide.mdx b/src/frontend/src/content/docs/community/contributor-guide.mdx index cadc81def..8e71f1e20 100644 --- a/src/frontend/src/content/docs/community/contributor-guide.mdx +++ b/src/frontend/src/content/docs/community/contributor-guide.mdx @@ -235,6 +235,16 @@ When contributing to `aspire.dev`, follow these writing guidelines to ensure con - **Follow formatting conventions** - Use consistent formatting for code snippets, commands, and technical terms. Refer to the examples in this guide for guidance. - **Review existing content** - Before adding new content, review existing documentation to avoid duplication and ensure coherence. +### Third-party links + +Third-party links can provide useful context, but they must serve the reader rather than the linked organization: + +- Include third-party links only when they are directly relevant, and use them sparingly. Prefer Aspire documentation when it covers the same information. +- Describe third-party resources factually and neutrally. Avoid endorsements, marketing language, promotional comparisons, and calls to purchase or sign up. +- Link to technical documentation or other substantive resources, not exclusively to a paid product, pricing, lead-generation, or sales page. +- Do not add content whose purpose is to promote a product or service that competes with Aspire. +- Disclose any material affiliation with the linked organization, such as employment, sponsorship, or ownership, in the pull request. An affiliation does not automatically disqualify a link, but the link and surrounding content must meet the same relevance and editorial standards as any other contribution. + ### AppHost-specific C# and TypeScript content When you are documenting AppHost-specific content that changes between C# and TypeScript, use synced `Tabs` and `TabItem` blocks with `syncKey='aspire-lang'`. Each code snippet should have its own C# and TypeScript selector, and the shared sync key keeps the selected language consistent across the page. From 122311d5b16b78c8316272aa8a6855d5a1b46ca1 Mon Sep 17 00:00:00 2001 From: David Pine Date: Wed, 29 Jul 2026 08:53:13 -0500 Subject: [PATCH 2/3] Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- .../src/content/docs/community/contributor-guide.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/frontend/src/content/docs/community/contributor-guide.mdx b/src/frontend/src/content/docs/community/contributor-guide.mdx index 8e71f1e20..e58243b7c 100644 --- a/src/frontend/src/content/docs/community/contributor-guide.mdx +++ b/src/frontend/src/content/docs/community/contributor-guide.mdx @@ -241,9 +241,9 @@ Third-party links can provide useful context, but they must serve the reader rat - Include third-party links only when they are directly relevant, and use them sparingly. Prefer Aspire documentation when it covers the same information. - Describe third-party resources factually and neutrally. Avoid endorsements, marketing language, promotional comparisons, and calls to purchase or sign up. -- Link to technical documentation or other substantive resources, not exclusively to a paid product, pricing, lead-generation, or sales page. -- Do not add content whose purpose is to promote a product or service that competes with Aspire. -- Disclose any material affiliation with the linked organization, such as employment, sponsorship, or ownership, in the pull request. An affiliation does not automatically disqualify a link, but the link and surrounding content must meet the same relevance and editorial standards as any other contribution. +- Link to technical documentation or other substantive resources, not to paid product marketing, pricing, lead-generation, or other sales-focused pages. +- Do not add content whose primary purpose is to market or promote a third-party product or service (for example, promotional comparisons positioned against Aspire). +- Disclose any material affiliation with the linked organization, such as employment, sponsorship, or ownership, in the pull request description (or in a top-level comment). An affiliation does not automatically disqualify a link, but the link and surrounding content must meet the same relevance and editorial standards as any other contribution. ### AppHost-specific C# and TypeScript content From 49c0315e564d062f5248bb2e64a96418133df273 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Wed, 29 Jul 2026 09:00:32 -0500 Subject: [PATCH 3/3] Address third-party link policy feedback Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> Copilot-Session: f983d401-1730-48ef-a79a-8d398376fcd3 --- .github/PULL_REQUEST_TEMPLATE.md | 16 ++++++++++++++++ .../content/docs/community/contributor-guide.mdx | 16 +++++++++------- 2 files changed, 25 insertions(+), 7 deletions(-) create mode 100644 .github/PULL_REQUEST_TEMPLATE.md diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 000000000..28b77bcf4 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,16 @@ +## Summary + + + +## Third-party links and affiliations + + + +## Validation + + diff --git a/src/frontend/src/content/docs/community/contributor-guide.mdx b/src/frontend/src/content/docs/community/contributor-guide.mdx index e58243b7c..7dadb7986 100644 --- a/src/frontend/src/content/docs/community/contributor-guide.mdx +++ b/src/frontend/src/content/docs/community/contributor-guide.mdx @@ -237,13 +237,15 @@ When contributing to `aspire.dev`, follow these writing guidelines to ensure con ### Third-party links -Third-party links can provide useful context, but they must serve the reader rather than the linked organization: - -- Include third-party links only when they are directly relevant, and use them sparingly. Prefer Aspire documentation when it covers the same information. -- Describe third-party resources factually and neutrally. Avoid endorsements, marketing language, promotional comparisons, and calls to purchase or sign up. -- Link to technical documentation or other substantive resources, not to paid product marketing, pricing, lead-generation, or other sales-focused pages. -- Do not add content whose primary purpose is to market or promote a third-party product or service (for example, promotional comparisons positioned against Aspire). -- Disclose any material affiliation with the linked organization, such as employment, sponsorship, or ownership, in the pull request description (or in a top-level comment). An affiliation does not automatically disqualify a link, but the link and surrounding content must meet the same relevance and editorial standards as any other contribution. +Third-party links are appropriate when they help readers complete a task or understand a topic. Apply these standards to both authored and generated content: + +- **Use links sparingly** - Include third-party links only when they're directly relevant. Prefer Aspire documentation when it covers the same information. +- **Present resources neutrally** - Describe third-party resources factually. Avoid endorsements, marketing claims, promotional comparisons, and calls to purchase or sign up. +- **Avoid promotion** - Don't add links or surrounding content whose primary purpose is to market a third-party offering or position it as a preferred replacement for Aspire. +- **Choose substantive destinations** - Link to technical documentation or other substantive resources. Don't link to product, pricing, lead-generation, or sales pages except as described in the following exceptions. +- **Allow necessary exceptions** - Prerequisite download or account sign-up pages, pricing or billing references needed for cost planning, and project descriptions or links on attribution and acknowledgment pages are allowed. Keep each exception limited to the context that makes it necessary. +- **Disclose affiliations** - In the **Third-party links and affiliations** section of the pull request description, disclose any material affiliation with a linked organization, such as employment, sponsorship, or ownership. An affiliation doesn't automatically disqualify a link, but the link and surrounding content must meet the same editorial standards as any other contribution. +- **Review generated content** - Automated updates and generated catalogs aren't exempt. They may reproduce upstream metadata when that's the catalog's explicit purpose, but the reviewing maintainer must apply the same editorial standards to the surrounding content and linked destinations. ### AppHost-specific C# and TypeScript content