carpentries
Impact of file name changes on links
The upcoming revision will include significant reordering of content and renaming of episode files, so current links to material in this report will get broken.
Could we add, in the revision, a rendered table (that could live under extras) that helps people find what they were looking for?
And link to that on this repo's 404?
This would also be useful for when we reorient trainers.
Because it just came up for me and I was deeply puzzled -- the lesson won't render if there are broken internal links. To test this it must be run locally with jekyll server until all the internal links resolve.
we'd fix the internal links; but external links (eg that people have saved, blog posts, etc) will be broken.
I'm proposing adding something like the following to the 404
We recently reorganized this lesson, a guide to what you may have been looking for is located
on the [chages page](extras/changetable)
Nice. And while we can link to the syllabus, that'll be renamed and whatnot, so just linking that is insufficient. I support this plan. Trying to maintain historical links strikes me as something that'll be a maintenance nightmare.
Good idea! @fmichonneau or @zkamvar can you weigh in on feasibility for this re modifying the 404 message?
We'll discuss this during our curriculum team meeting tomorrow and we'll get back to you. Thanks!
From the outside, I struggle to find context, but here's what I can piece together:
This issue stems from #1217, which will be fixed by #1215, but that PR doesn't currently contain any content. Can someone point me to a place where I can see what the revisions will be?
it's a major reivsion that is not done yet. episodes will be renamed, and coverage of topics will be moved from one episode to another. this summary table will be useful even in the latter case that doesn't address the broken links.
there are some piece of content in data lessons
Noting here that there have been recent improvements to the 404 page in styles that we should consider in how we handle this: https://github.com/carpentries/styles/pull/578
Now that the major update is merged, maybe we should return to this?
For example, some episodes have changed order and been renamed.
Everything internal is fine, but if someone was linking to 21-carpentries from somewhere else, that's now 15-carpentries. They'll get a 404 that doesn't help them find the information.
for pages that have a direct mapping (like 21-carpentries to 15-carpentries), we could set up redirects, for the others, I'm not sure what else we could do
There's a brute force solution here, which is to generate 301 redirect pages for all the old pages. Instead, would it be worth catching 404s https://jekyllrb.com/tutorials/custom-404-page/ and provide a custom 404 with the episode list in?