coding icon indicating copy to clipboard operation
coding copied to clipboard

Prefix issues with what module they affect

Open ValarDragon opened this issue 6 years ago • 3 comments

The idea is that alot of our issues hint at what module they are affecting already. (This is part of what makes the issue names meaningful) However, the module being affected is placed in various locations on the message, which makes it hard to see at a glance / harder to visually sort through. It would become easier if all of the issues put the module they affected at the beginning instead of various places. So for example: The following issue: "Add command to gaiad to show owner_address of a validator" Would become: "gaiad: add command to show owner_address of a validator"

I think this is going to be increasingly important now that tendermint is a monorepo. Golang has all issues from all of their extension repos under the same repo, at its easily searchable due to this: https://github.com/golang/go/issues

For issues that users create, we can just rename them, to make the title more reflective of what the underlying issue is. (This is a frequent occurence for golang's issue for example)

ValarDragon avatar Jun 21 '18 19:06 ValarDragon

Can module associations be tags instead of title prefixes? Easier to sort by tags.

cwgoes avatar Jun 21 '18 19:06 cwgoes

I personally think that module associations by prefix is more readable, and this ability to quickly read / scan through issues is valuable. (Also I think we can go into more granularity via prefixes than tags, i.e. tools/crypto/blake2b as opposed to just a crypto tag)

Tags could also be used in conjunction to do this. (We can also still search by name for modules, which replaces alot of this, though not a convenient single click, like tags) It makes sense to me to have tags used for the broader class of issue it falls under, and have the prefixing be more specific.

ValarDragon avatar Jun 21 '18 19:06 ValarDragon

Tags are not git native, Having prefixes in commit messages will ease navigation and use outside of Github.

xla avatar Jun 22 '18 00:06 xla