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

Document and conform to conventions for naming URLs #12

Open
2 tasks
garrison opened this issue Jul 20, 2020 · 0 comments
Open
2 tasks

Document and conform to conventions for naming URLs #12

garrison opened this issue Jul 20, 2020 · 0 comments
Labels
documentation Improvements or additions to documentation navigation Improvements to site navigation; i.e., a user's ability to find relevant content wiki cleanup Cleanup of content/structure from old Ductus wiki

Comments

@garrison
Copy link
Contributor

I only vaguely recall the rules we followed when choosing what to name pages within the wiki portion of the site, i.e., pages outside the group and user namespaces. The best I can remember is that we chose to place something, e.g., in the "English wiki" (content/en/) if the document's title/location was written in English. This is independent of whether a lesson actually teaches English, which is instead coded by the target-languages taxonomy.

A few questions:

  • Am I indeed remembering this correctly?
  • Does the existing convention make the most sense going forward?
  • How, in particular, do we want to handle the user and group sections from the old site?
  • If I am having trouble remembering the guidelines on this, I doubt it was followed by all contributors to the site, so there is surely cleanup to do.
  • Can our ideal scheme be made to work with Hugo's multilingual feature?

When content is moved or consolidated, an alias should be left at any old location(s). Since we first started the wiki, we have consistently followed the principle that cool URIs don't change.

  • Decide and document conventions
  • Implement site-wide conformance
@garrison garrison added wiki cleanup Cleanup of content/structure from old Ductus wiki navigation Improvements to site navigation; i.e., a user's ability to find relevant content documentation Improvements or additions to documentation labels Jul 20, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation navigation Improvements to site navigation; i.e., a user's ability to find relevant content wiki cleanup Cleanup of content/structure from old Ductus wiki
Projects
None yet
Development

No branches or pull requests

1 participant