dotnet / dotnet/docfx

HowTo Custom Template for enums

Open
#6,723 1 comment 0 reactions 0 assignees View on GitHub
dotnet dotnet: csharp
Dominant language
C#
Stars
4.4k
Forks
890
Avg merge
2h 11m
Merged PRs (30d)
10

Description

Sorry for posting as an issue, but I am not able to find an explicit forum of docfx.

I want to create an custom template for enums which includes the id. I found an entry here pointing to change {{name.0.value}} to {{syntax.content.0.value}} in the template. This works but not as I whish it to look like. The format is = in alphabetical order.

What I want to archive is a third column
Id | ItemName | Description

And I want it to be orderd by the Id, not the name. **How can I achive this?** Unfortunally I didn't found an documentation for the different values available (like {{name.0.value}}, {{syntax.content.0.value}}, ... )

Second question is about the attribute used for the description. I know the summary-field of the item of the xml-document is used for this. Unfortunally I need to read the Desciption programmatically so I tried using the System.ComponentModell.Description for that purpose which works well for reading at runtime but not for the documentation. **I don't want to create duplicate descriptions, so what can be a solution for enabeling both?**

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.