OILS / doc / published.md View on Github | oilshell.org

52 lines, 44 significant
1Published Docs
2==============
3
4This page links to docs that are ready to read.
5
6See [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