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

Page GettingStarted -> Installation does not exist #64

Closed
Vespasian opened this issue May 6, 2023 · 13 comments
Closed

Page GettingStarted -> Installation does not exist #64

Vespasian opened this issue May 6, 2023 · 13 comments
Assignees

Comments

@Vespasian
Copy link

https://podman.io/getting-started/installation linked from https://podman.io/docs/tutorials/podman_tutorial
errors out

@Vespasian Vespasian changed the title GettingStarted -> Installation does not exist Page GettingStarted -> Installation does not exist May 6, 2023
@vsoch
Copy link

vsoch commented May 6, 2023

+1 - I came here to say this! I did a good search for the install, clicked on the link, and it was a 404. And then I did the following:

  • Went to the main root -> "Getting Started"
  • There was no Install section of that. It assumes I have it installed
  • Then I tried "Documentation" assuming ti would be a bullet there, it was not
  • There is also no search, so I can't even search for the "install" term
  • There is no obvious installation tutorial either

From a user standpoint coming to the docs, my frustration level is 10/10. Please fix this asap!

@krwu
Copy link

krwu commented May 8, 2023

+1

I reinstalled one of my VPS and want to try podman instead of docker, but I failed at the very first step: "Installing podman by following its official guide".

@Luap99
Copy link
Member

Luap99 commented May 8, 2023

I agree due the new website move most links are just broken. I really would love if we could redirect all old links to the correct new places if necessary. See https://containers.github.io/podman.io_old/old/getting-started/installation for the old site. I don't understand why you moved everything under a old directory there, @TomSweeneyRedHat?

So far I did not find a replacement for the old installation instructions on the new site so we definitely have to add this back somewhere.

cc @containers/podman-maintainers @lilyx13 @mairin

@TomSweeneyRedHat
Copy link
Member

Thanks for the issue reports. We'll track down the issue and get things straightened out.

@ashx3s ashx3s mentioned this issue May 8, 2023
10 tasks
@ashx3s
Copy link
Collaborator

ashx3s commented May 8, 2023

Fixing this now. links will be updated shortly

@ashx3s
Copy link
Collaborator

ashx3s commented May 8, 2023

should be good after #67.

@ashx3s ashx3s closed this as completed May 8, 2023
@Luap99
Copy link
Member

Luap99 commented May 9, 2023

https://podman.io/getting-started/installation is still a dead link, please make it so it redirects to the new location.

@Luap99 Luap99 reopened this May 9, 2023
@ashx3s
Copy link
Collaborator

ashx3s commented May 9, 2023

where is this link being used? the new url is https://podman.io/docs/tutorials/installation

@Luap99
Copy link
Member

Luap99 commented May 9, 2023

Over the whole internet? Sure we can update the links in our repos but the main problem is the link is out there somewhere, blogs post, bookmarked by users, etc... we cannot just "update them".
I have no problems with having a new location but the old link should be redirected to the new one. I am not familiar with the docusaurus but in HTTP terms all we need is a HTTP 301 redirect. If you do not have time I can look into that, this is important to me.

@Luap99
Copy link
Member

Luap99 commented May 9, 2023

https://docusaurus.io/docs/docusaurus-core#redirect looks relevent

@mairin mairin self-assigned this May 9, 2023
@TomSweeneyRedHat
Copy link
Member

TomSweeneyRedHat commented May 9, 2023

@lilyx13, as @Luap99 noted, the links are all over the internet, we need to get them back if they're not already. That was what I was trying to do yesterday, had issues, and pinged you in slack about them.

@Luap99 , I moved everything in the old site to live under the "old" directory to make sure that someone didn't merge something in that repo (github.com/containers/podman.io_old) and then accidentally have everything for the new page be overwritten when a PR was merged. I had hoped that all the pages would pop up under podman.io/old for easier reference/accessibility, but that failed and I've not had time to track that down yet.

@ashx3s
Copy link
Collaborator

ashx3s commented May 10, 2023

In #92 I merged a change that will at least take care of this for pages searching for getting-started/installation. It's a little hacky, but I couldn't get the docusaurus module for redirects to work right, but in the pages/getting-started/ directory, there is a .tsx file for handling the installation redirect. others could be added if necessary with a slight modification of the url and the file name.

@Luap99
Copy link
Member

Luap99 commented May 10, 2023

@Luap99 , I moved everything in the old site to live under the "old" directory to make sure that someone didn't merge something in that repo (github.com/containers/podman.io_old) and then accidentally have everything for the new page be overwritten when a PR was merged. I had hoped that all the pages would pop up under podman.io/old for easier reference/accessibility, but that failed and I've not had time to track that down yet.

I see, yeah this is not going to work AFAIK. Each repo can only have one domain. To achieve something like this you would need a reverse proxy that we can configure. Github pages basically just allows one domain per repo. Or you would need to copy all the old pages over to this repo here.

I think the best way if you want to keep the old site around would be add a old.podman.io domain to the old repo (and then just revert old/ directory change there). This was users would be able to browse old.podman.io if necessary.


@lilyx13 Thanks, redirect seems to work fine me so I going to close this issue then.

@Luap99 Luap99 closed this as completed May 10, 2023
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

7 participants