Where To Send Feedback

We're looking for feedback on Oils! This includes:

• The compatible OSH language.
  • Does it run your shell and bash scripts?
  • How can we make debugging eaiser?
  • Are the error messages helpful?
• The new YSH language.
  • Do you like the syntax?
  • Does it work the way you expect?
  • What documentation do you need that is missing?
• The interactive shell (lower priority, but still welcome)

and more. You can:

• Open an issue on Github. You can also search for existing, related issues.
• Start a new topic on #oil-help or #oil-discuss on oilshell.zulipchat.com (requires login with Github or Google).
  • The "new topic" button is usually at the bottom of the page. For a quick overview of Zulip, see this picture and this blog post.
• Or chat with me directly. However basically anything is on topic for #oil-discuss. Don't be shy about asking! Many things are not documented, and your questions will help me fill that gap.

Feedback That's Useful

Bugs With a Specific Repro

• https://github.com/oilshell/oil/issues/1864#issue-2188861648 - crash in ctx
• https://github.com/oilshell/oil/issues/1822#issuecomment-1969880870 - bug running starship

Why does OSH/YSH behave like this?

Questions are always welcome. You may be pointed to a FAQ, but that's ok!

I want to do this in YSH, but I don't know how.

Even if you don't know exactly what you want to do, asking on #oil-help is valid! The language is still evolving, so we like to hear what problems people have using it.

I can't find docs on X.

The docs are still in progress, so this is unfortunately somewhat expected. Posting on #oil-help should give you a quick answer - either a link to existing docs, or an explanation that can be copied into docs.

[FAQ on Documentation](https://www.oilshell.org/release/latest/doc/faq-doc.html]()

I used YSH successfully.

This is great feedback, and worth posting even if you don't need a response! I enjoy reading success stories.

Less Useful Feedback

I want YSH to behave like this.

It's often better to start by clearly stating the problem, and only then then the solution you have in mind. There are always multiple solutions to any given problem.

Every person has a different background, so what's "intuitive" to one person may not be inuitive to another.

See Language Design Principles for some core axioms -- e.g. YSH is for Python and JavaScript users that avoid shell.