No documentation on how to use tags with docs pages

📚 Documentation

The release notes say you can now use tags like you can with blogs: https://github.com/facebook/docusaurus/releases/tag/v2.0.0-beta.5

I don’t think there’s documentation on “how to use tags with documentation files”.

I think you can just use the tags: property in the frontmatter of the .md file, like this?

---
title: Feature documentation
description: Learn about the new feature snorgleborf
tags: [snorgleborf, features]
---

The next version of the docs doesn’t mention tags: https://docusaurus.io/docs/next/create-doc

And the current version of the docs also doesn’t mention tags: https://docusaurus.io/docs/create-doc

Maybe the beta.5 documentation isn’t ready yet/not deployed? Or maybe I’m looking in the wrong place?

Have you read the Contributing Guidelines on issues?

Yes.

[Josh-Cena]

tags.yml or {tags} config option to override default tags settings like behavior etc, and maybe have the ability to provide a tag description or something…

So we are really getting into this global YAML config thing😹 Tag description sounds good to me, and having a global tags file also prevents typos like “back-end” and “backend” becoming two different tags

[slorber]

Doc PRs welcome if you want to add this.

Also, the website seems to still tag beta.5 as the next version?

Just a deploy failure, fixed now

In fact the tags front matter is more than an array of strings, because you can also set a custom permalink,

Actually, I’m not very fan of this “feature” that I suspect nobody is using. A tag can end up being declared twice with different permalinks, and first occurrence wins. I’d prefer to actually keep it undocumented and emit a warning on usage someday to see if it’s safe to remove or if it’s relied on. Eventually we could add a tags.yml or {tags} config option to override default tags settings like behavior etc, and maybe have the ability to provide a tag description or something…