Skip to content

Clarify demo (HF space) jargon - #132

Open
egrace479 wants to merge 3 commits into
devfrom
ref-122/clarify-jargon
Open

Clarify demo (HF space) jargon#132
egrace479 wants to merge 3 commits into
devfrom
ref-122/clarify-jargon

Conversation

@egrace479

@egrace479 egrace479 commented Aug 6, 2026

Copy link
Copy Markdown
Member

Add "demos" in parentheses next to "spaces" in catalog byline and the dropdown for clarification. This was discussed offline with @dboghrat as a simpler solution, since the proposed text was too long.

Screenshot of top of catalog with dropdown filter by repo type. the two times spaces are mentioned, demos is included in parentheses

Closes #122.

@egrace479
egrace479 requested a review from thompsonmj August 6, 2026 19:39
@egrace479 egrace479 added the design UX or presentation needs attention label Aug 6, 2026
@egrace479 egrace479 linked an issue Aug 6, 2026 that may be closed by this pull request
@hlapp

hlapp commented Aug 6, 2026

Copy link
Copy Markdown
Member

Perhaps we should simply replace "Spaces" with "Demos"? In the future we might have demos in places different than just HF Spaces, and widening that search to still surface all demos might get more involved. But on the flip side treating instead demos as HF Spaces and demos hosted in other ways differently would become confusing for the users. (For example, would we then have drop-down items "Spaces (demos)" and "Demos (not Spaces)"? Hopefully not.)

Conversely, do we have an existing example or conceivable plans to host something on a HF Space that is not a demo? I think not.

Therefore, I'd argue we should simply replace "Spaces" with "Demos".

@egrace479

Copy link
Copy Markdown
Member Author

Perhaps we should simply replace "Spaces" with "Demos"? In the future we might have demos in places different than just HF Spaces, and widening that search to still surface all demos might get more involved. But on the flip side treating instead demos as HF Spaces and demos hosted in other ways differently would become confusing for the users. (For example, would we then have drop-down items "Spaces (demos)" and "Demos (not Spaces)"? Hopefully not.)

Conversely, do we have an existing example or conceivable plans to host something on a HF Space that is not a demo? I think not.

Therefore, I'd argue we should simply replace "Spaces" with "Demos".

I'm inclined to agree with this change, especially with planned updates to have options other than HF (discussed in person with external collaborators this week).

@egrace479
egrace479 force-pushed the ref-122/clarify-jargon branch from edd7aec to 1536f12 Compare August 7, 2026 16:54

@hlapp hlapp left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM 👍🏻

Comment thread CITATION.cff
- data
- models
- spaces
- demos

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This reminds me that the list of keywords in the citation files (this one and .zenodo.json) is perhaps worth re-thinking. If these are the keywords that govern when this repo shows for a keyword being searched, several of the keywords seems too generic for expecting this repo to be an appropriate member in set of matches. For example, I'd say it's questionable whether this repo should show up when someone searches for "data", "demos", or "models.

Adding "demos" here doesn't really change the nature of the keywords (if they're too general, they already were so; if they were reasonably good, this should not change that), so may as well be part of the change set. But maybe worth discussing as a separate issue.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

design UX or presentation needs attention

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Describe "Hugging Face" and "Spaces" terminology

2 participants