dotnet / docs

This repository contains .NET Documentation.
https://learn.microsoft.com/dotnet
Creative Commons Attribution 4.0 International
4.26k stars 5.89k forks source link

create deep links for the C# specification. #8668

Closed BillWagner closed 5 years ago

BillWagner commented 6 years ago

There are 78 files that have links to the official C# spec. All of the listed files link to the introduction of the spec. Linking to the relevant of the spec would be a much better experience.

The destination links should be in the form:

[some topic](~/_csharplang/spec/some-file.md#anchor-for-the-section) 

The source for the C# 6.0 spec is in the dotnet/csharplang repo under the "spec" directory. Every heading should have an anchor tag that you can click to see the correct anchor in the browser address bar.

The blank lines in the list below suggest a possible breakdown for reasonable PR sizes. Community members that don't have write access won't be able to check the boxes. If you are submitting a PR for this issue, tag the issue, and we'll update the check list when we review and merge the PR.

If you find files that have already been updated with appropriate deep links (some have), add a comment here to check off that file.









TheSench commented 6 years ago

In adding links for internal, I also added public, private, and protected; as I noticed they were missing deep-links.

pkulikov commented 5 years ago

@BillWagner, as not all topics in the list are yet updated, this issue was closed by accident.

TheSench commented 5 years ago

My apologies, I am new to Pull Requests and marked them all as "Fixes #8668" instead of "Contributes to #8668". Bill caught most of them, but missed the last PR, which caused this issue to be closed.