UX: would you accept renaming the Settings Classes category to something more discoverable (e.g. Object Schema)?
#10920
MichaelUray
started this conversation in
Ideas
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Context
While working on the Workspace Access Center proposal (PR #10883 follow-up), an independent IA / naming review of the Settings sidebar surfaced one item I'd like to raise here before doing anything in our fork:
The
Settings → Classesentry exposes the Doc-class schema definitions (e.g.tracker.class.Issue,card.class.Card, mixins, inheritance). For workspace operators / admins coming from outside the Huly codebase, the term "Classes" reads as generic OOP jargon and gives no hint about its operational purpose ("am I editing user-visible labels? schema migrations? something dangerous?").Two operators we asked independently both guessed wrong ("permission classes?", "CSS classes?").
Proposal (open for discussion)
Rename the Settings category label only — not the underlying model symbols / TS class names — to one of:
Object Schema— most descriptive, matches what's actually shownData Schema— same idea, slightly broaderDocument Schema— accurate but might be confused with theDocumentpluginSchema— shortestWe'd keep the route key (
classes) for deep-link compatibility. Only the i18n string + sidebar icon caption change.Why I'm asking first
Renaming a top-level Settings entry in our fork is easy, but it creates terminology drift vs. upstream docs, training materials, support channels, and any future upstream-PRs we'd send. I'd rather:
Classesis a deliberate choice you want to keep — if yes, we accept it in our fork too.What I'm NOT proposing
class.Classmodel symbols (those are internal API).Objectplugin or related domain models.If there's a maintainer position on this already (issue, prior discussion, internal style guide), please point me at it.
Happy to send a PR with the chosen wording + the 13 locale files updated if there's interest.
All reactions