Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Sort out where words are listed and linked from/to #128

Open
quaid opened this issue Apr 1, 2022 · 3 comments
Open

Sort out where words are listed and linked from/to #128

quaid opened this issue Apr 1, 2022 · 3 comments
Assignees

Comments

@quaid
Copy link
Contributor

quaid commented Apr 1, 2022

Current situation

The main visible word list page doesn't link to the word lists directly, only from the menu.

The URL path to /word-lists/ does not have an index file, so gives a 404 error.

All of the terms are in two locations:

  • /word-lists/tier-N/ -- all terms are in the single tier file
  • /language/word-list/ -- one file for each term

Relevant URLs

Recommended fixes

  1. Create a file in the repo /website/content/word-lists/index.md that contains or links to the overview and tiered list.
  2. Remove the /word-lists/tier-N/ files as too cumbersome to keep a growing list of words in a single file. Create redirects from there to index.md.
  3. Rename /website/content/word-lists/overview.md to index.md, then have the Tier 1, 2, 3 subsections in the file contain a list of the terms, which are themselves links to the actual term.md file.
  4. Have a single file for all terms, located in /website/content/language/word-list/.
  5. Create a file /website/content/language/word-list/index.md that duplicates /website/content/word-lists/index.md.
    • Alternately, merge all together into a single relative path e.g. inclusivenaming.org/word-list/{index.md,term.md}
@abuango abuango self-assigned this Apr 1, 2022
@quaid quaid assigned quaid, abuango and LarryKunz and unassigned abuango Apr 6, 2022
@LarryKunz
Copy link
Contributor

Your ideas sound good, Karsten. Just so I'm clear: When you refer to term.md, should I assume that's a generic term referring to the Markdown files for each term? (Rather than a single term.md file containing all the definitions.) If so, then I'm good with that.

As for item (5), it sounds cleaner -- and easier to maintain going forward -- if we merge everything into a single relative path. But I defer to you and @abuango on that one.

@quaid
Copy link
Contributor Author

quaid commented Apr 12, 2022

Discussion from not-a-meeting:

  • Have a page per tier that is visually parsable by humans with: term, replacement, link to the full term page
  • One markdown file per term
    • Different people do the pull requests
  • @abuango is working on a proof of concept for automating the creation of index pages out of the individual markdown files (aiui)

@savage-alex
Copy link
Contributor

Is https://inclusivenaming.org/word-lists/ supposed to exist? If so it has no content I can see.

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

No branches or pull requests

4 participants