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

Servers > ANCM UE pass #5490

Closed
guardrex opened this issue Feb 16, 2018 · 3 comments
Closed

Servers > ANCM UE pass #5490

guardrex opened this issue Feb 16, 2018 · 3 comments
Assignees

Comments

@guardrex
Copy link
Collaborator

https://docs.microsoft.com/aspnet/core/fundamentals/servers/aspnet-core-module

@guardrex
Copy link
Collaborator Author

guardrex commented Feb 23, 2018

@Rick-Anderson @scottaddie @rachelappel Let's consider reducing/removing the acronym "ANCM" for "ASP.NET Core Module" in this topic.

  • It's only rarely used in topics outside of this topic:
    • static-files.md: 2
    • windowsauth.md: 1
    • nano-server.md: 0 (used as part of a script name)
  • After the initial reference to the "ASP.NET Core Module" in a section, it's satisfactory to just use "the module" thereafter.
  • It's not the name of the module file in IIS (aspnetcore.dll) or the name shown in the Modules list ("AspNetCoreModule").
  • It's not used on the .NET Downloads page or when running the hosting bundle installer.
  • Outside of our topics and GH issues, "ancm" doesn't provide relevant results on the first few pages of Google search results.
  • Should we be adding yet another acronym to the pantheon of acronyms in .NET 😓 only really useful for IIS insiders? The more acronyms there are, the more cryptic technology becomes.

@Rick-Anderson
Copy link
Contributor

AFAIK you need approval - see this.

TAWYG!
(Totally Agree With You Guys)

@guardrex
Copy link
Collaborator Author

It seems to me that this topic isn't a good spot to halfheartedly duplicate what's in the Hosting on IIS topic.

This section provides an overview of the process for setting up an IIS server and ASP.NET Core app. For detailed instructions, see Host on Windows with IIS.

Why? ... Why not just tell the reader to go access the Hosting on IIS topic and the module config reference, where the content is complete (including security coverage)?

I see a few gems in here that should be moved over to the Hosting on IIS and module reference topics, but I recommend some of these sections be removed.

This topic should probably just describe the basics of the module (what it is and what it does) and link out to our best coverage for using the module. Other than showing a few lines of code, the sample isn't valuable.

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

No branches or pull requests

2 participants