To disable gnu-ls (`gls`) even if it's installed in freeBSD and macOS
you can set it up with:
```zsh
zstyle ':omz:lib:theme-and-appearance' gnu-ls no
```

Closes #11647

BREAKING CHANGE: the previous zstyle setting to disable `lib/directories.zsh` aliases has
been changed to the new syntax: `zstyle ':omz:lib:directories' aliases no`. See
https://github.com/ohmyzsh/ohmyzsh#skip-aliases

 to see other ways you can use this setting.
    
Co-authored-by: Carlo Sala <carlosalag@protonmail.com>

Co-authored-by: Carlo Sala <carlosalag@protonmail.com>

Closes #11574
Closes #11579

Was linking to an old URL

Co-authored-by: Carlo Sala <carlosalag@protonmail.com>

Co-authored-by: Mohan Sha <mohansha@outlook.com>

Trying this on for size for a while.

Apple changed the name of their operating system from OS X to macOS a number of years ago. This was overdue!

As per issue  #10311

* refactor(osx): rename `osx` plugin to `macos`
* refactor(macos): Add symbolic link from old `osx` plugin name.

Co-authored-by: Marc Cornellà <hello@mcornella.com>

Fixes #8212

Co-authored-by: Sean Hellum <seanhellum45@gmail.com>

The ZSH_THEME_RANDOM_BLACKLIST variable will be deprecated until it's
removed 2 months from now.

Note: `upgrade_oh_my_zsh` is deprecated. Use `omz update` instead.

Co-authored-by: Marc Cornellà <marc.cornella@live.com>

Co-authored-by: Marc Cornellà <marc.cornella@live.com>
Co-authored-by: Bartek Pacia <barpac02@gmail.com>

The published workflow tests the installer and checks the syntax of known zsh files
in the project.

Co-authored-by: Marc Cornellà <marc.cornella@live.com>

Moving down below the intro copy so that first content to new-comers is a description of the project

* Change project URL from robbyrussell to ohmyzsh org

* Update git remote to use ohmyzsh org repository

Co-authored-by: Emil Engler <me@emilengler.com>
Closes #8157

The original suggestion for an unattended install downloads the installation script to a file, then runs that file with the --unattended argument. The install.sh file would be left behind after the suggested command was run.
This change passes the --unattended argument directly into sh. So, it's a nice one-liner like the default installation script, and it doesn't leave a dangling install.sh script.

After wandering into a few articles that discuss the difference between might and may...opting for may.

Add important notice about `chsh -s /bin/zsh` command requiring the user to log out and log back in to see the changes.