-
Notifications
You must be signed in to change notification settings - Fork 2.1k
Closed
Labels
C:docsComponent: DocumentationComponent: DocumentationT:uxType: Issue or Pull Request related to developer experienceType: Issue or Pull Request related to developer experience
Description
Given the highly technical nature of Tendermint as a product, the changelog is one of our most important communication mechanisms with users and deserves a little more attention going forward.
- We should, at the very least, add summaries for every release, with those summaries highlighting what we know to be important to users in that release.
- We should document some practices that can help us to better capture the essence of changes from users' perspectives so that it's not necessary to go read the code associated with a changelog entry to even get a faint sense of what the changelog entry's about.
If a changelog entry is obscure/esoteric, and its associated PR is light on details in the description, the only way for a user to understand the entry is to go read the code in the PR. In that case, what's the point of the changelog? They may as well just go read through the Git commit history.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
C:docsComponent: DocumentationComponent: DocumentationT:uxType: Issue or Pull Request related to developer experienceType: Issue or Pull Request related to developer experience
Type
Projects
Status
Done/Merged