ttscoff / bunch

Documentation repository for Bunch.app
https://bunchapp.co
116 stars 5 forks source link

Documentation: Suggestion to split @tag.frontmatter documentation #322

Closed sylumer closed 9 months ago

sylumer commented 9 months ago

This relates to the @tag.frontmatter section in the frontmatter documentation.

The current content of that section is this:


@tag.frontmatter

Another way to apply frontmatter to multiple Bunches is to use tag frontmatter. If a file beginning with @tagname.frontmatter exists, its frontmatter will be applied to all Bunches tagged with tagname.

Some keys such as “title prefix” and “ignore if/unless” are concatenated when they appear in multiple frontmatter. This allows you to assign an “icon” to each tag (with “title prefix”), and have menu items labelled with those icons, or to use tags to ignore (“ignore if/unless”) sets of Bunches on different machines.


The first paragraph relates to @tag.frontmatter, but the second paragraph seems more generic and not related to @tag.frontmatter. I would like to recommend making the second section its own section with its own heading.

sylumer commented 9 months ago

Upon reflection, I think I read too much into the first sentence of the second paragraph. Reading it back again, I believe I now understand better what it is saying and why this is explicitly relevant to the section.