feedback icon indicating copy to clipboard operation
feedback copied to clipboard

Inheritance should be inverted and it should omit the final class

Open mairaw opened this issue 6 years ago • 2 comments

Original GitHub issue https://github.com/dotnet/dotnet-api-docs/issues/1337 by @drowa

Instead of... Inheritance Object -> SubClass1 -> ... -> SubClassN -> ClassOnThisDocPage It should be... Inheritance SubClassN <- ... <- SubClass1 <- Object

This would follow the structure of the code, focusing on the immediate parent which is usually more relevant than Object.

Also, omitting the final class would make the 'Inheritance' part of the doc somehow more "symmetric" with the 'Implements' part.

Note that when using this rule, the doc page of the Object class would naturally lack the 'Inheritance' part (because we are omitting the final class).


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

  • ID: 6b66ab1a-35aa-1bba-388c-30d698c1f50c
  • Version Independent ID: d7dde1b9-fd16-dd30-6622-a15836579a9c
  • Content: HashSet<T> Class (System.Collections.Generic)
  • Content Source: [xml/System.Collections.Generic/HashSet1.xml](https://github.com/dotnet/dotnet-api-docs/blob/master/xml/System.Collections.Generic/HashSet1.xml)
  • Product: dotnet-api
  • GitHub Login: @mairaw
  • Microsoft Alias: mairaw

mairaw avatar Dec 11 '18 09:12 mairaw

@dend Can you take a look at this feedback?

Powerhelmsman avatar Dec 11 '18 17:12 Powerhelmsman

@mimisasouvanh please take a look at this customer suggestion

mairaw avatar Oct 04 '19 17:10 mairaw