Skip to content

docs: add a glossary page to describe some common terms#347

Open
Chew wants to merge 6 commits intoRetroAchievements:mainfrom
Chew:feat/glossary
Open

docs: add a glossary page to describe some common terms#347
Chew wants to merge 6 commits intoRetroAchievements:mainfrom
Chew:feat/glossary

Conversation

@Chew
Copy link
Copy Markdown
Contributor

@Chew Chew commented Apr 15, 2026

View this PR: https://feat-glossary.chew-ra-docs.pages.dev/general/glossary.html

This adds a simple Glossary page of what are common terms for active RA users but some newcomers may not understand.

This knowledge gap was revealed when a user came in asking what a mastery was. So, I decided to make a page that briefly describes a lot of RA specific terms, with links to more detailed pages if available to go into more detail.

Would appreciate feedback to make sure everything I have is accurate, or if anything needs to be added.

Comment thread docs/general/glossary.md

## Award / Badge

Awards, also sometimes referred to as badges, are given for completing various tasks.
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.

Awards are currently expressed only as badges, but this will change very likely before the end of the year. Not sure how we can make those two terms not synonymous.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

I see them referred to as Awards in events and the main profile page, which is where I got this from. Though I've heard them referred to as badges all the time colloquially.

Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md Outdated
Comment thread docs/general/glossary.md
## Standalone

Typically, all games run on an emulator. However, some games run standalone.
Currently, there are just Terraria and Final Fantasy XI, but more may be added in the future.
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 is very likely to drift/be stale this year. We should mention Terraria and FFXI, but maybe in a way that doesn't require an update once a 3rd standalone is added.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

How about

Typically, all games run on an emulator. However, some games run standalone (e.g. Final Fantasy XI and Terraria)

So this just lists them off as examples and not something that needs updating.

Comment thread docs/general/glossary.md Outdated
Chew and others added 2 commits April 15, 2026 12:22
Co-authored-by: Wes Copeland <wlcopeland1@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants