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 | - Language Design:
|
45 | - [Syntactic Concepts](syntactic-concepts.html)
|
46 | | [Command vs. Expression Mode](command-vs-expression-mode.html)
|
47 | | [Language Influences](language-influences.html)
|
48 | - Notes: [Novelties in OSH and YSH](novelties.html) | [Warts](warts.html)
|
49 | - Reference:
|
50 | - [Oils Error Catalog, With Hints](error-catalog.html)
|
51 |
|