Closed Poikilos closed 7 months ago
Seems to me like a duplicate of https://github.com/stephenmcd/mezzanine/issues/2030.
Seems to me like a duplicate of #2030.
That issue covers the readme aspects of my issue description, but not the main issue that is in my issue title. To resolve that, there would either have to be a real website or a set of permanent redirects of individual URLs, which still requires hosting of some sort (even if you just do it with .htaccess, with NGINX, with Apache, etc) unless there is some other way.
The docs now live here.
I do not believe that supporting deprecated URLs is possible.
Thanks for providing the URL. If there won't be hosting then changing the URLs to point to correct sections at that site would help #2030.
Uh, the documentation site still says 4.3.1. Does that imply it is not accurate, or should that be changed?
Also, generating a site as per the docs yields a "Home" page that contains the following bad URLs (after converted to markdown for the purposes of this document):
Welcome to your new Mezzanine powered website. Here are some quick links to get you started:
Here's one two of possibly dozens or hundreds of tech support answers that are currently faulty due to links to the old site that aren't being redirected (only redirecting each page from the old site to each matching section in the documentation would fix examples like this):
Are you aware you could do this with a "low end box" such as ones listed on lowendbox.com" VPS for something close to $20/yr in some cases? I'm not affiliated with them, and they just list various vendors so they are not a biased source.
Regarding stackoverflow, the best solution is to edit the stale link or add the fresh link as a comment as I have done on the two instances linked above.
Regarding hosting, I do not believe the domain is available. You could host it yourself and modify /etc/hosts
to point mezzanine.jupo.org to your hosted version.
Regarding stackoverflow, the best solution is to edit the stale link or add the fresh link as a comment as I have done on the two instances linked above.
Thanks for doing that. However, my point isn't that there are two, my point is that there are likely dozens or hundreds. I found the second one without even looking for it (it was on a related issue linked from the first). If I found 2 in about 2 minutes, I think I'd easily find 200 in 200 minutes.
Regarding hosting, I do not believe the domain is available.
How can the domain not be available if the domain owner (or subdomain renter) pointed the subdomain to github.com/stephenmcd/mezzanine? It seems pretty clear that the domain is still held by stephenmcd or some admin on this project. The subdomain was 404 not found until I e-mailed stephenmcd on 4/10/2022, then it soon after changed to redirect to this repo. @stephenmcd are you watching the repo and getting notified this issue exists and have you read my suggested solutions?
You could host it yourself and modify
/etc/hosts
to point mezzanine.jupo.org to your hosted version.
Uh, that wouldn't solve much for anyone but someone using my computer. Even if I did that on one of my servers, the person visiting my site wouldn't have my hosts file, and the host file wouldn't affect my website except on PHP Guzzle calls, Node request or superagent calls, etc (not even XMLHttpRequest, since that is client-side). There is already an existing site where all the links work: readthedocs. Whether you used my theoretical site or readthedocs, neither would help any of the linkbacks on every external site, which is what I've expressed as the issue.
My mistake regarding the domain. Dig that song, though!
Honestly, I feel like this is a solution in search of a problem. Links die, we do what we can to manage it. If the subdomain starts pointing to RTD, cool, but the repo seems like the best place to point it to me.
Ok but if links die on complex API documentation and dozens of page 1 google results for various terms on a major project that websites depend upon, I believe it is a very widespread problem in search of simple solutions that could take a day to fix. There is a concept in basically all major cloud services and open source web technologies called "permalinks" (or slugs) for a reason--all of those projects agree that this is a problem worth solving. When tech companies don't do it, it causes anyone trying to fix problems (with hardware, drivers, or software) endless and needless aggravation. There should be some level of professionalism (in this case, proactive support) on a tool such as mezzanine which is critical to businesses if they use it as their CMS. I hope to use to replace my WordPress instance and potentially those of other of my clients. Any solution I suggested falls under "what we can". I'd be glad to volunteer in some way, including hosting as I've said, or offering support for how to do NGINX or .htaccess redirects.
Please do create pull requests if you feel that you have a solution! I am no authority.
Fixing the links in the default homepage of an instance is, to my mind, the only actionable task in this thread. That would be a great first contribution for someone!
The search engines will re-index, and now that the site redirects to github, that shouldn't be a concern. RTD isn't hard to find; the docs in the repository are even easier, though I tend to read those in my editor.
Closing. I can't find any actions we can take to "fix" this, in particular because nothing is, strictly speaking, "broken".
The action to take to fix this is to honor permalinks (on many sites discussing using mezzanine, not just stackoverflow and not just your own docs that you can actually change to point to the new site) that are no longer permanent.
Is there an existing issue for this?
Current Behavior
Expected Behavior
I didn't know where the official repo was so I mentioned over e-mail that https://pypi.org/project/Mezzanine/ had bad links. That was fixed since then. However, the following from my e-mail still remains true regarding the "Current Behavior" above:
Plus, I actually want to be able to learn how to do the things to which the readme (used to) link, not just have the links deleted.
Steps To Reproduce
Environment
Anything else?
Examples of search engine results where clicking links on the first page will downrank your domain:
Example issue(s) containing links that are now bad, which may lead to issues recurring since people can't find the solution there anymore:
1991
Example issue(s) that link to jupo.org which has a bad cert:
268
Example page(s) that have links to "live demo" that no longer exist (I actually don't know where to find any Mezzanine 5 instance):
I can't find any documentation on how to set up a mezzanine 5 site other than a page somewhere that said it is now setup the same way as a DJANGO site, which is unclear, because mezzanine isn't DJANGO, so I know steps will differ, but which steps and how? The release's "docs" folder just has rst files which are unformatted and therefore the documents' structure is more difficult to follow visually without a Restructured Text viewer, and I can't click links to other files or have a table of contents even if I get such a viewer.