Skip to content

Commit 194ade8

Browse files
committed
Rework the Preface: interlinks, single sign-off, consistent voice
Each book's Preface now follows the same shape: - Beginner-tone welcome + what the book actually covers - Honest paragraph about what's hard, no sugar-coating - One sentence positioning the book as the material used in Stefan's trainings (subtle, not pushy) - Interlink to the sibling book(s) where it actually helps the reader (prerequisite language book, cross-stack equivalent, etc.) — links use full canonical wintermeyer-consulting.de URLs rather than xrefs since they cross Antora components - How to read: sidebar is unlocked, but front-to-back is the fastest path - Single sign-off at the end of "Don't be a stranger" Phoenix book drops the standalone "Stefan Wintermeyer" mid-page line — the preface is now signed once, at the end.
1 parent cdeb25a commit 194ade8

1 file changed

Lines changed: 28 additions & 17 deletions

File tree

modules/ROOT/pages/index.adoc

Lines changed: 28 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,25 +4,36 @@ Stefan Wintermeyer <sw@wintermeyer-consulting.de>
44

55
Learning https://elixir-phoenix-ash.com/elixir/[Elixir],
66
https://elixir-phoenix-ash.com/phoenix/[Phoenix] and
7-
https://elixir-phoenix-ash.com/ash/[Ash] is a
8-
steep climb. No sugar-coating. This book aims to make that ascent
9-
less steep — it's the same route I take when I run Phoenix and
10-
Ash trainings, written so you can work through it on your own.
11-
It's a guide crafted for beginners.
12-
13-
* *A step-by-step guide.* While no prior knowledge is required, a basic
14-
understanding of programming and HTML will be beneficial.
7+
https://elixir-phoenix-ash.com/ash/[Ash] is a steep climb. No
8+
sugar-coating. This book is my attempt to make that ascent less
9+
steep — a beginner's guide, written in the same step-by-step
10+
shape I use when I run Phoenix and Ash trainings.
11+
12+
* *Step-by-step.* No prior Elixir or Phoenix knowledge required;
13+
a basic grasp of programming and HTML is beneficial.
1514
* *Bite-sized "Hello World!" code examples.* Crafted for
16-
comprehension just by reading the code, with added notes for clarity. No abstract
17-
programming theories.
15+
comprehension just by reading the code, with notes added for
16+
clarity. No abstract programming theory.
1817
* *Simplicity is key.* My goal is to get you productive ASAP.
19-
* *Not a beauty contest.* We're not investing much time in aesthetics. This is
20-
not a CSS design book.
21-
22-
If a section doesn't resonate with you, skip it. You can circle back later
23-
if needed. I recommend reading the book in order, but it's not required.
24-
25-
Stefan Wintermeyer
18+
* *Not a beauty contest.* We're not investing much time in
19+
aesthetics. This is not a CSS design book.
20+
21+
**The Elixir basics live in their own book.** If pattern
22+
matching, the pipe operator, GenServer or Mix are still
23+
strange, start with
24+
link:https://wintermeyer-consulting.de/elixir/book/[Elixir] —
25+
the language primer — and come back here for the framework.
26+
27+
Coming from Ruby on Rails? Phoenix is conceptually the Rails of
28+
the BEAM. The Rails-specific sibling book is at
29+
link:https://wintermeyer-consulting.de/rails/book/[Learn Ruby
30+
on Rails].
31+
32+
The sidebar lets you jump to any chapter at any time — nothing
33+
is locked, later chapters don't assume you memorised the
34+
earlier ones. That said, the book is written to be read front
35+
to back: each chapter sets up the next. If a section doesn't
36+
resonate, skip it — you can circle back later if needed.
2637

2738
== Don't be a stranger
2839

0 commit comments

Comments
 (0)