[FR] index pages for individual tags

[paloaltonetworks]

[FR] index pages for individual tags

[sserrata]

Hi @matoous, yes, but it needs a little more work before it's ready. The idea will be to allow users to select whether they want to use "tag" descriptions or "info" as the "index" page for categories. See #100 for details.

[matoous]

@sserrata just gave it a try, exactly what we were looking for! Awesome, thanks a lot 🙏

[welcome-to-palo-alto-networks]

🎉 Thanks for opening your first issue here! Welcome to the community!

[sserrata]

Thanks for the FR @matoous! We can certainly take a look to see if this is possible and would definitely appreciate a contribution.

[matoous]

@sserrata I see this new commit made it's way to main: e17c515, is it related to this?

[sserrata]

Hi @matoous, the changes have been merged and can be tested using canary release 0.0.0-355. Be sure to also upgrade the theme.

Please see the README.md for usage or just adapt this example:

petstore: {
  specPath: "examples/petstore.yaml",
  outputDir: "api/petstore",
  sidebarOptions: {
    groupPathsBy: "tags",
    categoryLinkSource: "tag",
  },
},

Interested in your feedback on the end result and usage. Thanks!