"Side Bar: Count Badge" preference not specified

[Chealer]

The Bookmark extension's Side Bar: Count Badge preference has the following description:

Controls the count badge on the Bookmark icon on the Activity Bar

It can have 3 values:

• all
• files
• off

Unfortunately, the labels all not clear and the description does not specify what they mean.

---

• Extension version: 13.5.0

[alefragnani]

H @Chealer ,

This setting is documented in the README file, presented in the Marketplace page:

---

• Controls the count badge on the Bookmark icon on the Activity Bar (all by default)

  • all: Show the sum of bookmarks from all files
  • files: Show the sum of files that contains some bookmarks
  • off: Disable the Bookmarks count badge

    "bookmarks.sideBar.countBadge": "files"

---

And the same description is provided within the VS Code Settings Editor, both UI and JSON, as you can see in the print below:

Do you mean you didn't find its descriptions, or you didn't understand what each one of them mean?

Hope this helps

[Chealer]

Thank you very much @alefragnani
To clarify, here is the section @alefragnani refers to.

[Chealer]

Do you mean you didn't find its descriptions, or you didn't understand what each one of them mean?

I hadn't found the descriptions. I am sorry I hadn't read the README, but I admit that I didn't expect that this information would be in the README but not in the user interface. I recommend to have that information in the description (above) or to clarify the labels. I suggest to simply replace the current labels with the "label explanations" in the README. However, these explanations are themselves not so clear. For instance, does "Show the sum of files that contains some bookmarks" mean to show the number of files which contain at least one bookmark?

By the way, I believe the README's Features section is excessively long. For reference, even the features section of a large product's documentation like MySQL's fits in 3 pages.

[alefragnani]

Well, the labels could indeed be more verbose, similar to the bookmarks.multicursor.toggleMode setting, but I think their descriptions provides a reasonable message. Specifically about the contains some bookmarks, yes, it means contains at least one bookmark. I'll update the description as you suggested.

About updating the labels, this is not straightforward, since users may have already selected some actual label, and replacing it with a new value won't automatically migrate. For this reason, the labels will remain the same.

Hope this helps