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.

Introducing a Code of Conduct based on the Contributor Covenant project. Adding links from the README and CONTRIBUTING pages to this, too, along with an email address for reporting abusive behavior to. Closes #7733 (#7734)