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

Rename: pages/{osx => macos} #5013

Closed
bl-ue opened this issue Dec 5, 2020 · 12 comments
Closed

Rename: pages/{osx => macos} #5013

bl-ue opened this issue Dec 5, 2020 · 12 comments
Labels
decision A (possibly breaking) decision regarding tldr-pages content, structure, infrastructure, etc. mass changes Changes that affect multiple pages.

Comments

@bl-ue
Copy link
Contributor

bl-ue commented Dec 5, 2020

With macOS Big Sur, the major version of macOS has changed from 10 to 11. Now the osx folder is wrong because it's macOS 11, not macOS X.

@sahilister sahilister added decision A (possibly breaking) decision regarding tldr-pages content, structure, infrastructure, etc. mass changes Changes that affect multiple pages. labels Dec 5, 2020
@bl-ue
Copy link
Contributor Author

bl-ue commented Dec 5, 2020

CLIENT-SPECIFICATION.md needs to be updated.

@bl-ue
Copy link
Contributor Author

bl-ue commented Dec 5, 2020

Theses page need to be updated too:

pages/common/spatial.md
pages/osx/bless.md
pages/osx/pkgutil.md
pages/osx/afinfo.md
pages.es/osx/afinfo.md
pages.zh/osx/afinfo.md

@bl-ue bl-ue mentioned this issue Dec 5, 2020
6 tasks
@sbrl
Copy link
Member

sbrl commented Dec 11, 2020

Hey there, @bl-ue! Thanks for bringing this up. Unfortunately, this is a difficult problem, as a platform rename will result in a breaking change for tldr clients. Updating all of the tldr clients out there is a big task that will take quite a long time. Furthermore, we'll need to figure out a way to do this in a non-breaking fashion, to avoid causing issues for clients during the transition period.

@bl-ue
Copy link
Contributor Author

bl-ue commented Dec 11, 2020

all of the tldr clients out there

@sbrl Are there more clients then the Node.js client, the Python client, and the C client?

@sbrl
Copy link
Member

sbrl commented Dec 11, 2020

Absolutely! Check out the list here: https://github.com/tldr-pages/tldr/#how-do-i-use-it

tldr-pages has a large and diverse community :D

@bl-ue
Copy link
Contributor Author

bl-ue commented Dec 11, 2020

Wow, I can't believe I didn't notice that section. Hm...we could just merge this issue into #4120, @sbrl?

@sbrl
Copy link
Member

sbrl commented Dec 19, 2020

Ah, no worries!

Yeah, probably. It's a large and complex operation that requires lots of co-ordination. Somehow I don't think it's going to happen anytime soon, I'm afraid.

@bl-ue
Copy link
Contributor Author

bl-ue commented Dec 19, 2020

I might be able to coordinate it some time :)

@bl-ue
Copy link
Contributor Author

bl-ue commented Jan 6, 2021

@sbrl

Furthermore, we'll need to figure out a way to do this in a non-breaking fashion, to avoid causing issues for clients during the transition period.

We could temporarily symlink osx -> macos.

@sbrl
Copy link
Member

sbrl commented Jan 7, 2021

I believe symlinks are an issue. Check out #787, and also potentially #1966 (but that one is long and complicated).

@CleanMachine1
Copy link
Member

I think we should close this.

@bl-ue bl-ue closed this as completed Sep 14, 2021
@bl-ue
Copy link
Contributor Author

bl-ue commented Sep 14, 2021

Done :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
decision A (possibly breaking) decision regarding tldr-pages content, structure, infrastructure, etc. mass changes Changes that affect multiple pages.
Projects
None yet
Development

No branches or pull requests

4 participants