Skip to content

Conversation

@arturl
Copy link
Contributor

@arturl arturl commented Oct 31, 2025

Removes the standalone Copilot article from the AI documentation section and redirects all Copilot URLs to the Neo product page. Copilot has been superseded by Neo, so the documentation should point users to the current product.

Changes:

  • Removed /docs/ai/copilot/_index.md and associated images
  • Added copilot URL aliases to /product/neo.md to redirect to Neo
  • Removed copilot aliases from /docs/ai/_index.md
  • This removes "Copilot" from the Infrastructure AI sidebar menu

Fixes https://github.com/pulumi/pulumi.ai/issues/2155

Removes the standalone Copilot article from the AI documentation section
and redirects all Copilot URLs to the Neo product page. Copilot has been
superseded by Neo, so the documentation should point users to the current
product.

Changes:
- Removed /docs/ai/copilot/_index.md and associated images
- Added copilot URL aliases to /product/neo.md to redirect to Neo
- Removed copilot aliases from /docs/ai/_index.md
- This removes "Copilot" from the Infrastructure AI sidebar menu

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@pulumi-bot
Copy link
Collaborator

@arturl arturl marked this pull request as ready for review October 31, 2025 16:54
@arturl arturl requested review from CamSoper and jkodroff October 31, 2025 16:55
@claude
Copy link
Contributor

claude bot commented Oct 31, 2025

Review of PR #16439

This PR correctly removes the standalone Copilot documentation and redirects to the Neo product page. The implementation follows best practices for file removal and URL preservation.

✅ Strengths

  1. SEO preservation: All Copilot URLs are properly aliased in content/product/neo.md:4 to redirect to Neo, preventing broken links and preserving search rankings.

  2. Clean removal: The deleted Copilot documentation file and associated images are no longer needed since Neo supersedes Copilot.

  3. Menu cleanup: Removing Copilot aliases from content/docs/ai/_index.md:17-20 correctly removes "Copilot" from the Infrastructure AI sidebar menu as intended.

  4. File newlines: All modified files properly end with newlines.

📝 Observations

Internal documentation links: Several documentation pages still reference the old Copilot URLs (e.g., /docs/ai/copilot/):

  • content/docs/iac/comparisons/cloud-template-transpilers/aws-cdk/_index.md:58
  • content/docs/insights/discovery/_index.md:29
  • content/docs/deployments/get-started/_index.md:74
  • content/docs/deployments/get-started/what-is-it.md:58

Status: This is acceptable. The aliases in neo.md will handle these redirects automatically. However, per AGENTS.md guidelines, you may want to update internal links in /content/docs/ strategically for cleaner references:

find content/docs -name "*.md" -exec sed -i 's|/docs/ai/copilot/|/product/neo|g' {} +

Blog posts: Multiple blog posts reference old Copilot URLs. Per AGENTS.md, blog posts are historical documents and should NOT be updated. The aliases will handle redirects. ✅

✅ Verification

  • Aliases properly added to moved content
  • Files end with newlines
  • Frontmatter properly formatted
  • Follows AGENTS.md guidance for file removal
  • SEO impact mitigated through aliases

Summary

This PR is ready to merge. The aliases ensure all old Copilot URLs redirect properly to Neo, preserving SEO and preventing broken links. Internal documentation link updates are optional but not required since aliases handle redirects.


Mention @claude if you'd like me to update the internal documentation links or review any other changes.

@claude
Copy link
Contributor

claude bot commented Oct 31, 2025

Documentation Review

This PR successfully removes the standalone Copilot documentation and redirects all Copilot URLs to the Neo product page. The implementation follows the repository's file deletion and aliasing guidelines.

✅ What's Good

  • Proper alias implementation: All four Copilot URL patterns have been correctly added as aliases to content/product/neo.md:
    • /docs/ai/copilot/
    • /docs/pulumi-cloud/copilot/
    • /docs/intro/copilot/
    • /docs/intro/pulumi-cloud/copilot/
  • Clean removal: Copilot aliases removed from content/docs/ai/_index.md
  • Associated assets removed: Images properly deleted ✓
  • SEO preserved: The aliases ensure existing external links and search engine rankings won't break ✓

📝 Suggestion: Update Internal Links

According to AGENTS.md (lines 90-96), when moving/deleting documentation files, internal links in active documentation should be updated to point directly to the new location rather than relying on redirects.

The following files in /content/docs/ have internal links to /docs/ai/copilot/ that should be updated to /product/neo:

content/docs/insights/discovery/_index.md:5

3. **Exploration**: Once scanning completes, explore your infrastructure through [Resource Search](/docs/insights/discovery/search/), which provides powerful filtering, grouping, and natural language queries via [Pulumi Neo](/product/neo).

content/docs/deployments/get-started/_index.md:15 (approximate line)

- **[Pulumi Neo](/product/neo)**: AI assistant for debugging, code generation, and infrastructure questions

content/docs/deployments/get-started/what-is-it.md:23 (approximate line)

[Pulumi Neo](/product/neo), an AI assistant built into Pulumi Cloud, collaborates with you to solve a variety of challenges you might encounter.

content/docs/iac/comparisons/cloud-template-transpilers/aws-cdk/_index.md:32 (approximate line)

- __AI-powered__: [Pulumi Neo](/product/neo) is an AI-powered assistant that automates any infrastructure management task.

Note

The API reference file content/docs/reference/cloud-rest-api/copilot/_index.md also has a copilot alias but may need separate consideration since it's API documentation.


Overall, this is a well-executed redirect. The alias implementation is correct and will preserve SEO. The internal link updates are optional but recommended for cleaner documentation and better performance (avoiding unnecessary redirects).

Mention me (@claude) if you'd like me to help make these internal link updates or if you have questions about the review.

Copy link
Contributor

@CamSoper CamSoper left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perfect, thank you @arturl!

@arturl arturl merged commit 142d32d into master Oct 31, 2025
15 checks passed
@arturl arturl deleted the arturl/remove-copilot-article branch October 31, 2025 17:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants