Skip to content

Commit 0bb860d

Browse files
committed
reedit chapter 0 paragraph 2
1 parent c3bb273 commit 0bb860d

File tree

1 file changed

+55
-36
lines changed

1 file changed

+55
-36
lines changed

chapter/text0.md

+55-36
Original file line numberDiff line numberDiff line change
@@ -4,17 +4,17 @@
44
========================
55

66

7-
* [goals](#goals) and [methods](#methods)
8-
* [few prerequisites](#prerequisites)
7+
* [goals](#goals) and [methods](#teaching-method)
98
* [layout of the whole and structure of each chapter](#chapter-layout)
9+
* [few prerequisites](#prerequisites)
1010
* [Perl philosophy](#perl-philosophy)
1111
* [basic syntax rules](#basic-syntax-rules)
1212
* [first tiny example: hello math !](#first-example)
1313

1414

1515

1616
[Goals](#chapter-0)
17-
--------------
17+
-------------------
1818

1919
Welcome,
2020
to this hands on tour through the more often needed parts of this vast and beautiful
@@ -29,46 +29,50 @@ programming language. You can find here:
2929

3030

3131

32-
[Methods](#chapter-0)
33-
-----------
32+
[Teaching Method](#chapter-0)
33+
-----------------------------
3434

35-
While all the action might be mostly between "you and your computer", we try to give
36-
you a feel that someone is guiding you in a real-world programming situation.
35+
While all the action takes place between "you and your computer", we try to
36+
give you a feel that someone is guiding you in a real-world programming situation.
3737
You will be able to follow a train of thought from the first strategic decisions,
38-
to the selection process to find the most suitable Perl feature,
39-
then to the trying out of several ways to formulate it, up to the finishing edits
40-
of the implementation. Some evaluation helps you understand what has been achieved.
38+
to the selection process of finding the most suitable Perl feature,
39+
then to the trying out of several ways to formulate it, up to the polishing edits.
40+
A final evaluation helps to understand, what has been achieved.
4141

42-
That sounds like lot of text - but we actually tried to keep it informative and concise -
43-
advancing with a rather fast pace. Therefore we encourage you to read a chapter or
44-
paragraph repeatedly, as long you feel like not fully understanding it. We think
45-
that is way better than having to work through boring passages. Links to detailed
46-
information will be provided on the spot needed.
42+
That sounds like lot of text - but we actually do our best to keep it concise.
43+
Links to more detailed information will be provided on the spot needed.
44+
The tutorial also advances with a rather fast pace. Therefore we encourage you to
45+
read a chapter or paragraph repeatedly, as long you feel like not fully getting it.
46+
If an explantation just dind't made sense to you - please let us know via github.
47+
It is most important to us not to bore and provoke your own inquiries.
4748

48-
The flip side of this practical, yet dense approach: you have to stick for the most
49-
part with the order of the content and won't be able to skip even several sentences.
50-
Because you might overlook this way an important feature, the next tho pages build upon.
51-
It is one program, that developes constantly from front to back. Some parts stay
52-
over long phases the same - other getting replaced quickly. While we strongly recommend
53-
to adapt the program to your wishes, you should be be aware that maintaining them
54-
through the whole tutorial might be a big extra task.
49+
The flip side of this practical, yet dense approach: you (mostly) have to stick
50+
with the order of the content and won't be able to skip even several sentences.
51+
Because then you overlook the introduction of an important feature, which will be
52+
premised over and over. This is especially true during the chapter 1-6 and an
53+
inevitable side effect of developing one program throughout the whole tutorial.
54+
While we strongly recommend to adapt it to your wishes, you should be be aware,
55+
that maintaining them through all changes can be a demanding task.
5556

5657

5758

58-
[Prerequisites](#chapter-0)
59+
[Chapter Layout](#chapter-0)
5960
--------------------------
6061

61-
- curiosity
62-
- few programming basics
63-
- any editor
64-
- any shell
65-
- an open browser
62+
63+
Each chapter has a main topic and some (often related) subtopics.
64+
6665

6766
----
6867

68+
!!! from here on the text is in raw state !!!
69+
70+
----
71+
72+
start with some bits
73+
main parts
74+
some bits
6975

70-
[Chapter Layout](#chapter-0)
71-
--------------------------
7276

7377
if you ever wondered what Perl 6 is able
7478
to this practical Tutorial, aimed to people who learn the most while
@@ -80,24 +84,39 @@ into more complicated settings without getting lost. Not much programming or
8084
computer science knowledge is therefore required, just an occasional
8185
lookup in wikipedia or a search engine.
8286

87+
88+
89+
90+
8391
> At the end of each chapter stands a working program,
8492
> which hopefully becomes useful to you.
8593
8694

8795
During the course an application
88-
is built which might
89-
Each chapter
90-
for teaches you enough of this
9196
It requires almost none background in programming or computer science -
92-
just handling a search engine should be fine.
9397
What it aims that filled in by quick search,
9498

9599

96-
[Perl Philosophy](#chapter-0)
100+
101+
[Prerequisites](#chapter-0)
97102
--------------------------
98103

104+
- curiosity
105+
- few programming basics
106+
- any editor
107+
- any shell, to run the scripts (unless you can do it from inside the editor)
108+
- an open browser connected to the net
109+
110+
111+
112+
[Perl Philosophy](#chapter-0)
113+
-----------------------------
114+
115+
116+
117+
99118
[Basic Syntax Rules](#chapter-0)
100-
--------------------------
119+
--------------------------------
101120

102121

103122

0 commit comments

Comments
 (0)