zsh-workers
 help / color / mirror / code / Atom feed
From: Roman Perepelitsa <roman.perepelitsa@gmail.com>
To: Daniel Shahaf <d.s@daniel.shahaf.name>
Cc: Zsh hackers list <zsh-workers@zsh.org>
Subject: Re: Official plugin manager?
Date: Fri, 3 Jan 2020 23:37:12 +0100	[thread overview]
Message-ID: <CAN=4vMqxOAVOY_9k9rPO3=BtTEjvBebxGCkpm2ZmP-CuySrrEQ@mail.gmail.com> (raw)
In-Reply-To: <54205248-124e-4e9a-942f-7ff0626791a6@www.fastmail.com>

On Fri, Jan 3, 2020 at 11:07 PM Daniel Shahaf <d.s@daniel.shahaf.name> wrote:
>
> Roman Perepelitsa wrote on Fri, 03 Jan 2020 21:51 +00:00:
> > This is just my personal opinion that I don't hold very strongly and
> > my voice obviously carries little weight here. I think zshrc
> > recommended by zsh should be very conservative. It should enable users
> > to get started (basic keys must work,
>
> Debian does something like this:
>
> https://salsa.debian.org/debian/zsh/blob/debian/debian/newuser.zshrc.recommended
> https://salsa.debian.org/debian/zsh/blob/debian/debian/zshrc

This looks along the lines of what I was suggesting and what would
make my life easier when I was switching to zsh.

I'd suggest a few minor changes.

- Inline the prompt definition instead of using promptinit. This makes
it much easier for users to customize prompt. Abstractions are a
serious barrier for beginners.
- Move keybindings (everything, really) from the global zshrc to the
user and remove fancy indirection from there as well (don't use
terminfo and don't define auxiliary assoc arrays). This will show
users how to define bindings. Also get rid of zle-line-begin/end hooks
and stop changing terminal mode. Do something like this instead:
https://www.reddit.com/r/zsh/comments/eblqvq/d/fb7337q/. This is
easier to understand and more robust.
- More comments explaining what things do and where to find docs.
E.g., comments above bindings should say which key is being bound and
what the widget does. It should also explain how to figure out escape
codes for different keys and where to find the list of builtin
widgets.
- Maybe fewer completion styles. Seems like too much but maybe they
are really important, I don't know.

One meta observation based on my experience doing the same with
powerlevel10k. 90%+ of users won't ever open the default config file.
90% of those that do, won't read any documentation that isn't included
in the file itself.

Roman.

  parent reply	other threads:[~2020-01-03 22:38 UTC|newest]

Thread overview: 34+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-01-02  3:17 Sebastian Gniazdowski
2020-01-02  4:28 ` Eric Cook
2020-01-02 11:03 ` Daniel Shahaf
2020-01-02 11:37   ` Sebastian Gniazdowski
2020-01-02 11:55     ` Sebastian Gniazdowski
2020-01-02 21:30     ` dana
2020-01-03  0:25       ` Sebastian Gniazdowski
2020-01-03  1:36         ` dana
2020-01-03  2:43           ` Sebastian Gniazdowski
2020-01-03  2:45           ` Bart Schaefer
2020-01-03  3:26             ` dana
2020-01-03  5:13               ` Sebastian Gniazdowski
2020-01-03 15:00               ` Peter Stephenson
2020-01-03 20:48                 ` Daniel Shahaf
2020-01-03 21:51                   ` Roman Perepelitsa
2020-01-03 22:06                     ` Daniel Shahaf
2020-01-03 22:26                       ` Bart Schaefer
2020-01-03 22:37                       ` Roman Perepelitsa [this message]
2020-01-04  0:42                         ` dana
2020-01-04  1:06                           ` Daniel Shahaf
2020-01-04 15:46                           ` Roman Perepelitsa
2020-01-04 16:27                             ` Daniel Shahaf
2020-01-04 16:41                               ` Roman Perepelitsa
2020-01-04 17:35                                 ` Daniel Shahaf
2020-01-04 17:42                                   ` Roman Perepelitsa
2020-01-04 17:11                             ` Bart Schaefer
2020-01-05 10:40                               ` Oliver Kiddle
2020-01-06 17:47                   ` Leah Neukirchen
2020-01-03 11:15             ` Oliver Kiddle
2020-01-04  5:16               ` Sebastian Gniazdowski
2020-01-04  6:00                 ` Sebastian Gniazdowski
2020-01-02 12:00   ` Roman Perepelitsa
2020-01-02 12:21     ` Sebastian Gniazdowski
2020-01-02 12:27       ` Roman Perepelitsa

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to='CAN=4vMqxOAVOY_9k9rPO3=BtTEjvBebxGCkpm2ZmP-CuySrrEQ@mail.gmail.com' \
    --to=roman.perepelitsa@gmail.com \
    --cc=d.s@daniel.shahaf.name \
    --cc=zsh-workers@zsh.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.vuxu.org/mirror/zsh/

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).