Enhancement: Description/Help for metadata field definitions

Is your feature request related to a problem? Please describe.

I’m working on a default frontmatter.json definition for users of my Hugo theme to be able to leverage because Front Matter seems like a tool that is absolutely going to help me give those users a more delightful experience. While trying to configure the metadata fields, I noticed that they don’t have something like an optional description key, which would help keep users from having to look things up.

Describe the solution you’d like

Ideally, there would be an optional description or help key (not fussed about the name) for metadata fields which would:

• Display when a user hovers over that field name in the UI
• Display in fainter text beside or below the field name

I think from a UX perspective, show-on-hover by default with an option to always display would be really stellar. If no description is provided, you get no hover text nor a description after the field name.

Describe alternatives you’ve considered

I could extend the title key for the metadata fields to include this information, but that could be distracting or confusing, I think.

Additional context

N/A

[estruyf]

It just a simpel description line that is supported, but this gave me an idea.

Would a divider and header (which can include a description) make sense? That way, you can split the fields in sections.

[michaeltlombardi]

Confirmed and it looks good! I tried using newlines which didn’t work, but I think that’s probably fine.