| 1 | Published Docs
|
| 2 | ==============
|
| 3 |
|
| 4 | This page links to docs that are ready to read.
|
| 5 |
|
| 6 | See [All Docs](index.html) for links to drafts.
|
| 7 |
|
| 8 | ## Good Places to Start
|
| 9 |
|
| 10 | - [Getting Started](getting-started.html)
|
| 11 | - [A Tour of YSH](ysh-tour.html)
|
| 12 | - [YSH vs. Shell Idioms](idioms.html)
|
| 13 | - [**Oils Reference**](ref/index.html) - underlies the [help][] builtin
|
| 14 | - [FAQ on Docs](faq-doc.html). **Look here if you can't find
|
| 15 | something**.
|
| 16 |
|
| 17 | [help]: ref/chap-builtin-cmd.html#help
|
| 18 |
|
| 19 | ## More
|
| 20 |
|
| 21 | - OSH:
|
| 22 | - [Known Differences Between OSH and Other Shells](known-differences.html)
|
| 23 | | [Quirks](quirks.html)
|
| 24 | | [Tracing Execution](xtrace.html)
|
| 25 | | [Headless Mode](headless.html)
|
| 26 | | [Shell Idioms](shell-idioms.html)
|
| 27 | - YSH:
|
| 28 | | [A Feel For YSH Syntax](syntax-feelings.html)
|
| 29 | | [YSH Style Guide](style-guide.html)
|
| 30 | | [What Breaks When You Upgrade to YSH](upgrade-breakage.html)
|
| 31 | | [YSH Language FAQ](ysh-faq.html)
|
| 32 | - Comparisons: [YSH vs. Shell](ysh-vs-shell.html) | [YSH Expressions vs.
|
| 33 | Python](ysh-vs-python.html)
|
| 34 | - Features: [Egg Expressions (YSH Regexes)](eggex.html)
|
| 35 | | [YSH Regex API](ysh-regex-api.html)
|
| 36 | | [Guide to YSH Error Handling](ysh-error.html)
|
| 37 | | [Guide to Procs and Funcs](proc-func.html)
|
| 38 | | [YSH Fixes Shell's Error Handling](error-handling.html)
|
| 39 | | [Simple Word Evaluation](simple-word-eval.html)
|
| 40 | | [Variable Declaration, Mutation, and Scope](variables.html)
|
| 41 | | [Hay - Custom Languages for Unix Systems](hay.html)
|
| 42 | - Data Languages:
|
| 43 | - [JSON](json.html) | [J8 Notation](j8-notation.html) |
|
| 44 | [BYO Protocols](byo.html)
|
| 45 | - Language Design:
|
| 46 | - [Syntactic Concepts](syntactic-concepts.html)
|
| 47 | | [Command vs. Expression Mode](command-vs-expression-mode.html)
|
| 48 | | [Language Influences](language-influences.html)
|
| 49 | - Notes: [Novelties in OSH and YSH](novelties.html) | [Warts](warts.html)
|
| 50 | - Reference:
|
| 51 | - [Oils Error Catalog, With Hints](error-catalog.html)
|
| 52 |
|