Best Practices for Subcategories and Tags

Hey Hopscotchers,

We’re excited to announce the biggest update to the Bugs category since its creation! These changes will help us to identify and sort bugs more easily, and hopefully make it so the developers of Hopscotch can address these bug reports faster.

How to use tags in the #hopscotch-bugs category

What are the updated tags?

Staff Tags

These are tags that can only be modified by leaders and staff, and they are used to indicate the status of a bug report.

#high-priority – bug reports with this tag are being prioritized in development
#in-development – The Hopscotch Team is currently working on fixing this bug, and it will be fixed in a future release.
#officially-reproduced – if a topic has this tag, the Hopscotch Team has verified that the bug occurs consistently

User Tags

You can add these tags to your topic to give a general idea of what’s being affected by the bug.

#accounts – bugs related to any account-related functionality, such as logging in, logging out, changing your profile or username, etc.
#crashing – bugs that cause the Hopscotch app to crash or a webpage to reload unexpectedly
#data-loss – bugs related to losing project or account data in Hopscotch.
#framerule – bugs related to sequence or calculations in Hopscotch not being performed correctly
#modded-only – bugs that are still due to Hopscotch’s code, but require modding such as browser extensions or project JSON modifications.
#notifications – anything related to notifications in Hopscotch.
#text-bug – anything related to text not working properly.
#visual – bugs that are purely visual and do not affect usability.

#security – If you believe you found something unintentional that users can abuse (i.e. taking other people’s seeds or changing someone else’s username), please add this tag to your topic. Briefly describe the effect of the bug, and do not include steps to reproduce it. We will reach out to you in private to collect more details for security bugs.

How do I use them as the creator of the bug report?

By using these tags, you are helping the Hopscotch team provide more detail on what is happening with the bug you’re reporting. Is it related to accounts? Add the #accounts tag. Does it crash the app? Mark it with #crashing. You can add multiple user tags (see previous heading) to your topic, and all of them should be related to the bug you are reporting.

The leaders and Hopscotch staff will also be able to mark development status and priority so that you all can get a better sense of where each bug is in the process of getting fixed!

How does this help the Hopscotch Team?

The Hopscotch team will be able to look at bugs that are related to their part of Hopscotch development. These tags will make it clear which issues are related to each other, and it will be easier to find bugs that are able to be fixed easily since we can filter topics by tag now.


About the new subcategories in #hopscotch-bugs

What are the new subcategories?

The new subcategories are #hopscotch-bugs:editor, #hopscotch-bugs:player, #hopscotch-bugs:web-explorer, and #hopscotch-bugs:ios-community.

While you can still post bugs in the main category, we strongly recommend that you choose a subcategory, as topics in the main category will be eventually be recategorized to help the devs.

Editor Bugs

Use this category to report bugs that occur when you’re editing your code. This includes objects not appearing correctly on the stage, code being added or removed unexpectedly when you’re editing, etc.

Player Bugs

Use this category to report bugs that occur when you’re playing projects. For example, if the “bumps” rule is firing when you don’t expect it to, log the bug here.

Web Explorer Bugs

Use this category to report bugs that occur when browsing through the web explorer. This is the place for anything that happens in the web explorer while browsing the community. If it occurs when playing a project, please file the bug report under #hopscotch-bugs:player.

iOS Community Bugs

Use this category to report bugs with your profile or the community in the iOS app. Examples include profile pictures not showing correctly, certain tabs not working, or projects failing to sync or upload to the community.

Need help deciding which category your bug report falls under?

Here’s a quick and comprehensive guide on which category works best for your bug report!

How does this help the Hopscotch Team?

Like tags, bug reports can be filtered by subcategory using the selector at the top-left of the screen. This allows developers to look into bugs in categories that relate to parts of Hopscotch that they can work on at that time.


Are there any new guidelines for the #hopscotch-bugs category?
  1. Try not to tag anyone in the first post of the bug report. Many of us are already watching this category, and removing tags while editing topics gets tedious very quickly.
  2. Only mark a post as the image if the occurrence of the “bug” is actually intentional or if an update has been pushed that does solve the issue for you. A solved topic tells us that the bug no longer occurs.

Other than that, we just ask that you do your best to add the appropriate tags and subcategory to your bug report, and that titles and the entire template are filled out and descriptive. More detail makes bugs easier to approach, identify, and fix!


Feel free to ask questions, give feedback, and offer tag suggestions on this topic, and we’ll do our best to provide an answer as quickly as possible!

18 Likes

Cool! I can tell this will be very helpful. Great post btw.

11 Likes

Neeto! This’ll be helpful.

9 Likes

Awesome! This’ll be great for finding bug reports if something happens as well

10 Likes

awesome topic, well explained!
this 100% deserves to be bumped - check this topic out y’all!

4 Likes