ohmyzsh / wiki Goto Github PK

Describe the bug

The ohmyzsh cheatsheet lists cd as an ohmyzsh alias for navigating to one's home directory.

According to the zsh docs, however, this is a built-in:

Change the current directory. In the first form, change the current directory to arg, or to the value of $HOME if arg is not specified. If arg is ‘-’, change to the previous directory.

... so I'd suggest to remove it to avoid confusion/misleading users (contributed to by the fact the cheatsheet specifically states it "has been edited to only show main Oh My Zsh tricks").

If the ~ tilde is indeed an ohmyzsh alias, that of course makes sense to keep, and its description could e.g. be updated to point out it duplicates the built in cd behaviour.

Describe the bug

Screenshot of mikeh theme is outdated.

Now it is looks completely different.

Steps to reproduce

1. Set ZSH_THEME="mikeh" in ~/.zshrc

Expected behavior

The theme does not match the example in the screenshot.

Screenshots and recordings

The theme looks like this:

OS / Linux distribution

Fedora 36

Zsh version

5.8.1

Oh My Zsh version

master (4c82a2e)

Terminal emulator

Alacritty

If using WSL on Windows, which version of WSL

No response

Additional context

No response

I'm a newbie to OMZ. I find your list of plugins to be really interesting, but also rather intimidating. I have no idea of what each one does or which ones I should install. I could click through each link, of course, but with ~100 different options, that's not realistic. I've come across this page several times, and each time I conclude, "this is too complicated" and skip installing plugins.

Some of the underlying packages are self-evident, like "Python." However, most of these names mean nothing to me. E.g., what does "autojump" do?

Even the description after I click through is rather bare: "This plugin loads the autojump navigation tool." This sounds intriguing, but it isn't informative unless (a) you already know what autojump does or (b) you have the time to click through to the underlying package and read the detailed description.

Would it be possible to expand this page with a description for each plugin and the underlying package? The descriptions would ideally have a one or two sentence summary about "why should I care?" -- or "what makes this awesome?" I.e., more than "this plugin loads X" or "this plugin adds syntax highlighting for Y." Rather, there would ideally be a short summary of the underlying package, like "Autojump is X and does Y." Perhaps a table format would work better, not a list.

I'd be happy to volunteer to write a first pass and submit a pull request, although it would require some research and time. I wouldn't want to do this unless there was buy-in. It would help if anyone could volunteer to review a first draft before I submit a formal pull request.

Just my two cents. Thanks for maintaining a great package!

Originally posted by @RobJacobson in ohmyzsh/ohmyzsh#11650