Azure-devops-docs: supported languages link is now bad

[jarek91]

The link in the line "Set a language identifier for the code block to enable syntax highlighting for any of the supported languages." under Code highlighting goes to the latest version of the readthedocs site for highlightjs. In the latest version, the list of languages has been removed from the documentation. Currently the list still exists in stable but this will eventually change as well. The list of supported language specifications is really needed so if highlightjs is not going to list them, we need to find a new list or make one hosted here.

---

Document Details

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

• ID: fa622358-f5bb-1f5c-177a-081a37b6acef
• Version Independent ID: 72f7fd16-a822-66c8-3a34-8905645ce5f2
• Content: Markdown syntax for files, widgets, and wikis in Azure DevOps - Azure DevOps
• Content Source: docs/project/wiki/markdown-guidance.md
• Product: devops
• Technology: devops-collab
• GitHub Login: @chcomley
• Microsoft Alias: chcomley

[Bafff]

Is that correct link maybe? https://github.com/highlightjs/highlight.js/tree/master/src/languages

Or that? https://highlightjs.org/download/

[jarek91]

Both of those links contain the information but it is cumbersome to get. What the old documentation (stable) shows is a table of the language and what aliases you can use to set your code fence to that language. Your first link requires you to either use a particular filename (without extension) or to open the file and see what aliases are acceptable for that language. The latter gives you a cleaner list but none of the aliases. The ideal solution is to have a table like the stable version of the highlight.js docs have:

[chcomley]

Hi @jarek91, I'll look into this and be in touch. Thanks for reaching out!

[Bafff]

@chcomley what has changed?

[chcomley]

@Bafff, I added the following bolded text to the article, showing which versions the link supports: "Set a language identifier for the code block to enable syntax highlighting for any of the supported languages, version v9.10.0 or later versions." Thanks!

[Bafff]

@chcomley maybe I don't understand something but I think we need to have a link to the page with exact names of languages that wiki supports. Or please point me how can I find it from your link from docs. Sorry if I'm missing smth obvious

[chcomley]

@adramasu, can you please help us here...thanks

[adramasu]

We are consuming highlightjs version 9.10.0. The link has the list of languages for the specified version. We will update the documentation to point to this link. cc :@chcomley

[Bafff]

That's what we wanted I think