For me, I’ve always learned best from books that show examples. In particular, I appreciate when the examples are consistent throughout and used to illustrate each new thing I’m learning so I can check my understanding as I go against the worked example that the author provided.

So I will use some examples from this book, and other examples that are shorter. Initially I used some empty text or fake text called lorem ipsum text too.

So for example, here is this section written in AsciiDoc plain text format:

== By Example (1)
For me, I've always learned best from books that show examples. (2)
In particular, I appreciate when the examples are consistent throughout and used to illustrate each new thing I'm learning so I can check my understanding as I go.
      (3)
So I decided to use examples from this book in most cases. (4)
Initially I used some empty text or fake text called lorem ipsum text too.

So for example, here is this section written in AsciiDoc plain text format: (5)
  1. The "== " indicates a title.

  2. First paragraph

  3. Paragraph break

  4. Second paragraph

  5. Third paragraph

This example shows how easy plain text is to write. There is very little markup. I’ll show more specifics as we go in the book.

Then by using these examples, you can build your AsciiDoc skills a layer at a time. This follows the pattern of building skill with gradually building challenge. As you build the skill, then you will see productivity gains like I’ve experienced.

Image

Line By Line

Here a Little, There a Little, Layer by Layer.

Back to Overview