This repository was archived by the owner on Nov 2, 2023. It is now read-only.
Align page and file names #179
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
It has long annoyed me that our page names and filenames don't match. I open specification-links.md when I mean to open documentation.md probably half the time at least. * Update "gems" to "plugins" to get jekyll to stop complaining * Add the redirect plugin * Rename documentation.md to specification.md and add a redirect * Change the title of implementations.md to Implementations Remove most remaining links to ".md" URIs and standardize on ".html" which seems to be what we've been going for. I think there are still example links with ".md" but I did not want to touch the examples at all for now.
While there's not much we can do with the .txt or .xml files in the top level directory right now, we can make the .html use a redirect so we can put it in its draft-NN directory as we do with the more recent drafts. For the .txt and .xml files, while you can get Jekyll to process them, the redirect plugin is implented by emitting an HTML file with a canonical link header, as there is no access to the web server itself to respond with an HTTP redirect code.
Relequestual
approved these changes
Dec 4, 2017
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
It has long annoyed me that our page names and filenames don't
match. I open specification-links.md when I mean to open
documentation.md probably half the time at least.
I decided that I prefer "Specification" over "Documentation"
and "Implementations" over "Software", but that's definitely
open to discussion.
Remove most remaining links to ".md" URIs and standardize on
".html" which seems to be what we've been going for. I think
there are still example links with ".md" but I did not want
to touch the examples at all for now.
@adamvoss let me know if this will mess up anything you're doing
with analytics. Or perhaps we should just take stock of what the
analytics have told us so far and then feel free to change things?