openlibhums / openlibhums/janeway
Consistent names for pages and buttons
@S-Haime is already working on this.
Since Aug 27, 2025.
- Dominant language
- Python
- Stars
- 239
- Forks
- 97
- Avg merge
- 9d 1h
- Merged PRs (30d)
- 8
Description
Problem
We do not yet have a consistent style in the Janeway user interface for the names of buttons, pages, panes, boxes, etc. Sometimes things are capitalized with title case (Edit Metadata), sometimes with sentence case (Upload new stylesheet). Often phrases are used that start with a verb and describe an action or user goal (Edit Metadata), and other times the names are nouns referring to places in the app (the Manager page).
Proposal
To make feature development easier and make the interface more consistent, we should explore whether there are general principles we should adopt for existing and future Janeway interfaces.
- Assess best practices
- https://kubie.co/blog/fighting-feature-names/
- https://uxbooth.com/articles/the-grammar-of-interactivity/
- https://medium.com/the-product-marketer/the-art-of-feature-naming-four-survival-tips-76bd86f82cff
- accessibility
- translation and localization
- exceptions to rules of thumb
- what users who know Janeway expect
- what users who do not know Janeway expect
- Identify what rules of thumb we might want to follow
- Identify what changes to current names in Janeway could or should be made all at once
- Document any choices in the developer docs, such as in a new guide to copywriting
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.