isocpp / isocpp/CppCoreGuidelines
[Azure DevOps Wiki] The Toc entry is a broken link; it neither navigates to the topic content nor populates a functional, linkable URL into the address bar.
@hsutter is already working on this.
Since Jun 20, 2019.
- Dominant language
- CSS
- Stars
- 45.3k
- Forks
- 5.6k
- PR merge metrics
- No merged PRs in 30d
Description
The current Core Guidelines uses a GitHub-only markdown extension ("a name" references) to create links from the TOC to the target items. Office is trying to adopt the core guidelines and for compliance reasons, it needs to be hosted within an Azure Dev Ops (ADO) wiki. Currently, this is done by pulling the content from Github and rebasing some minor Office specific changes to the content. The issue is that ADO does not support the "a name" extension. Other "repo providers" such as bitbucket also do not support the "a name" extension, see discussion here:
This means that the TOC links will be broken for people hosting the content outside of GitHub.
Would it be possible to replace the Core Guidelines TOC with an automatically generated TOC by using the [[TOC]] extension for Github, see here
This extension is automatically supported by ADO.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.