Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[IA] Rename site section paths to dotnet from net #6582

Open
4 tasks
chalin opened this issue Mar 20, 2025 · 5 comments
Open
4 tasks

[IA] Rename site section paths to dotnet from net #6582

chalin opened this issue Mar 20, 2025 · 5 comments
Labels
cleanup/refactoring e1-hours Effort: < 8 hrs enhancement New feature or request IA Information architecture rework p2-medium sig:dotnet

Comments

@chalin
Copy link
Contributor

chalin commented Mar 20, 2025

There is an inconsistency in the site URL paths used for .Net sections relative to other languages. We're currently using net in these two places:

The path name "net" seems wrong. Besides, we use dotnet as our language ID internally, and that would also make more sense as a site URL path segment name.

I'd propose that we change it to dotnet. This will simplify some of our internal code that needs to single-out the exception and special-case it at the moment, and make the site URL paths more intuitive.

Thoughts @svrnm @open-telemetry/docs-approvers @open-telemetry/dotnet-approvers? If we do make the change, we'll use direct rules to ensure that the old URLs (using net) continue to work.

Tasks

  • Rename the paths under content of /docs/languages/net and /docs/zero-code/net to use dotnet instead of net
  • Add appropriate redirects
  • Fix the registry too
  • Adjust any shortcodes and/or includes, e.g., layouts/shortcodes/docs/languages/exporters/intro.md and it's associated include.
@svrnm
Copy link
Member

svrnm commented Mar 20, 2025

I am in favor of this change. Especially with redirects we can have both 👍

@theletterf
Copy link
Member

Agree with going for dotnet, it's more idiomatic to the .NET ecosystem.

@tiffany76
Copy link
Contributor

I agree. dotnet is better.

@Kielek
Copy link
Contributor

Kielek commented Mar 20, 2025

I am fine with dotnet as long as we have redirectins in place.

@chalin
Copy link
Contributor Author

chalin commented Mar 20, 2025

Note that we'll also need to adjust the registry code, since it was coded with net. I'll add this subtask to the opening comment too.

@chalin chalin added enhancement New feature or request e1-hours Effort: < 8 hrs p2-medium cleanup/refactoring sig:dotnet IA Information architecture rework labels Mar 20, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
cleanup/refactoring e1-hours Effort: < 8 hrs enhancement New feature or request IA Information architecture rework p2-medium sig:dotnet
Projects
Status: No status
Development

No branches or pull requests

5 participants