| 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 |
|
| 23 | - [Known Differences Between OSH and Other Shells](known-differences.html) |
|
| 24 | [Quirks](quirks.html) | [Headless Mode](headless.html) | [Shell
|
| 25 | Idioms](shell-idioms.html)
|
| 26 |
|
| 27 | YSH:
|
| 28 |
|
| 29 | - [A Feel For YSH Syntax](syntax-feelings.html) | [YSH Style
|
| 30 | Guide](style-guide.html) | [What Breaks When You Upgrade to
|
| 31 | YSH](upgrade-breakage.html) | [YSH Language FAQ](ysh-faq.html)
|
| 32 |
|
| 33 | - Comparisons: [YSH vs. Shell](ysh-vs-shell.html) | [YSH Expressions vs.
|
| 34 | Python](ysh-vs-python.html)
|
| 35 |
|
| 36 | - Features: [Egg Expressions (YSH Regexes)](eggex.html)
|
| 37 | | [YSH Regex API](ysh-regex-api.html)
|
| 38 | | [Guide to YSH Error Handling](ysh-error.html)
|
| 39 | | [Guide to Procs and Funcs](proc-func.html)
|
| 40 | | [YSH Fixes Shell's Error Handling](error-handling.html)
|
| 41 | | [Simple Word Evaluation](simple-word-eval.html)
|
| 42 | | [Variable Declaration, Mutation, and Scope](variables.html)
|
| 43 | | [Hay - Custom Languages for Unix Systems](hay.html)
|
| 44 |
|
| 45 | Data Languages:
|
| 46 |
|
| 47 | - [JSON](json.html) | [J8 Notation](j8-notation.html) | [BYO
|
| 48 | Protocols](byo.html)
|
| 49 |
|
| 50 | Language Design:
|
| 51 |
|
| 52 | - [Syntactic Concepts](syntactic-concepts.html)
|
| 53 | | [Command vs. Expression Mode](command-vs-expression-mode.html)
|
| 54 | | [Language Influences](language-influences.html)
|
| 55 | - Notes: [Novelties in OSH and YSH](novelties.html) | [Warts](warts.html)
|
| 56 |
|
| 57 | The Shared Oils Runtime
|
| 58 |
|
| 59 | - [Types in the Oils Runtime](types.html) | [Tracing Execution](xtrace.html)
|
| 60 |
|
| 61 | Reference:
|
| 62 |
|
| 63 | - [Oils Error Catalog, With Hints](error-catalog.html)
|
| 64 |
|