Phinx: Docs site isn't updated

[berarma]

The site http://docs.phinx.org is getting out of date. Did something break or is it updated manually?

[dereuromark]

Shouldnt this redirect to the new docs then? @markstory

[markstory]

I don't know how or where the hosting for docs.phinx.org is setup unfortunately.

[dereuromark]

Fixed now

[MasterOdin]

https://docs.phinx.com is still way out of date. It's being built through the readthedocs.org platform and it looks like it was last synced about a year ago: https://readthedocs.org/projects/phinx/builds/.

If the intention is to have everyone use https://book.cakephp.org/3/en/phinx.html, it might be worth deleting it from RTD so that it stops being a top result on google.

[dereuromark]

@robmorgan ping

[robmorgan]

Hmmmm I think I'll do two things.

1. Point the Phinx marketing site (https://phinx.org), directly to https://book.cakephp.org/3/en/phinx.html
2. Setup a 301 from docs.phinx.org directly to https://book.cakephp.org/3/en/phinx.html

Sound good?

[robmorgan]

Just thinking out loud - the only problem with that approach is we'd need to remember to bump the CakePHP Version number in the URL for every major release.

[dereuromark]

Maybe we could also point it to a entry point that auto redirects to latest major

https://book.cakephp.org/en/phinx.html

e.g. would then show or find+redirect the latest
@markstory that is doable?

That way it is always true.

[markstory]

We can make https://book.cakephp.org/phinx always resolve to the latest english docs.

It doesn't work yet but I can get it working.

[dereuromark]

Cool, once that is done, we can ping rob to set the link.

[robmorgan]

For now I've started redirecting http://docs.phinx.org/ to https://book.cakephp.org/4/en/phinx.html. I'll shutdown readthedocs for SEO purposes at some point.

[markstory]

@robmorgan If you have a chance could you change the redirect to https://book.cakephp.org/phinx/ that URL will do one additional redirect and end up at the current release docs going forward.

[robmorgan]

@markstory I've updated the link now:

*://docs.phinx.org -> https://book.cakephp.org/phinx/

[igorsantos07]

Just wanted to point out to @robmorgan that https://phinx.readthedocs.io/ is still stealing the scene on some searches

PS.: should the docs contain all options, or just leave that to the (confusing) help commands? If so, I can try writing a PR with the missing stuff, like --fake.

[robmorgan]

@igorsantos07 chiming in here 6 months later, I've now finally removed the Phinx docs from readthedocs.io so the search results will start returning a 404 and gradually be removed from the index.

[igorsantos07]

Awesome, man! Great you got the time for that!

On Wed, Jun 23, 2021, 02:50 Rob Morgan @.*> wrote:

@igorsantos07 https://github.com/igorsantos07 chiming in here 6 months
later, I've now finally removed the Phinx docs from readthedocs.io so the search
results https://phinx.readthedocs.io/en/latest/migrations.html will
start returning a 404 and gradually be removed from the index.

—
You are receiving this because you were mentioned.
Reply to this email directly, view it on GitHub
https://github.com/cakephp/phinx/issues/1648#issuecomment-866548415, or
unsubscribe
https://github.com/notifications/unsubscribe-auth/AAEB6S5EPCRNZ4CQUTRZYJTTUFY2FANCNFSM4JVYL47A
.