[website] removed h3 from outline, fixed some API pages #2679
+53
−14
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Motivation and Context
I removed H3 headings from the outline on API pages because it was redundant in the majority of the cases. H3 headings almost always duplicate parent headings:
Also fixed some specific API pages: fixed structure, added missing types.
We could get rid of manually added H2 headings and replace auto generated type name headings with H2 level, but there are some concerns:
InputTags.ValuevsInputTagsValueProps). I'm also not sure it's beneficial for anyone to know the type names.In conclusion, I think it would be easier to stay with only the manually edited H2 headings in the outline for now.
I have some ideas how we could improve API pages structure, but it would require more work, so it's better to do it in a separate task.
How has this been tested?
Screenshots (if appropriate):
Types of changes
Checklist: