Skip to content

Commit 349dc0b

Browse files
committed
clean up menean up menu
2 parents ff9a578 + eccf022 commit 349dc0b

File tree

2 files changed

+44
-46
lines changed

2 files changed

+44
-46
lines changed

chapter/text0.md

+29-38
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,10 @@ Welcome,
2020
to this hands on tour through the more often needed parts of this vast and beautiful
2121
programming language. You can find here:
2222

23-
- syntax knowledge
24-
- bits of deeper understanding for the design decisions
25-
- room for own experiments
26-
- a useful application
23+
- syntax knowledge:
24+
- bits of deeper understanding for the design decisions:
25+
- room for own experiments:
26+
- a hopefully useful application:
2727
- a taste of the full capabilities
2828
- sources for further learning (docs and more)
2929

@@ -35,22 +35,26 @@ programming language. You can find here:
3535
While all the action takes place between "you and your computer", we try to
3636
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 of finding the most suitable Perl feature,
39-
then to the trying out of several ways to formulate it, up to the polishing edits.
38+
to the selection process of finding the most suitable Perl feature, to the
39+
following trying out of several ways to formulate it, up to the polishing edits.
4040
A final evaluation helps to understand, what has been achieved.
4141

42-
That sounds like lot of text - but we actually do our best to keep it concise.
42+
That sounds like lot of text - but we actually try to keep it concise as possible.
4343
Links to more detailed information will be provided on the spot needed.
4444
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.
45+
reread a chapter or paragraph, if you felt like not fully understanding it.
46+
Or you follow the trail of code snippets in a chapter. Running them as oneliner,
47+
and and using them as basis of explorations might be your favorite learning style.
48+
Rereading a chapter after that also clarifies a lot.
49+
And reading the chapter after some minutes of such adventure can clarify.
50+
When an explantation still doesn't makes sense to you - please let us know via github.
4751
It is most important to us not to bore and provoke your own inquiries.
4852

4953
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.
54+
with the given order and won't be able to skip even several sentences.
5155
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.
56+
premised over and over. This is especially true during chapter 2-6 and an inevitable
57+
side effect of developing one example program throughout the whole tutorial.
5458
While we strongly recommend to adapt it to your wishes, you should be be aware,
5559
that maintaining them through all changes can be a demanding task.
5660

@@ -59,8 +63,10 @@ that maintaining them through all changes can be a demanding task.
5963
[Chapter Layout](#chapter-0)
6064
--------------------------
6165

62-
63-
Each chapter has a main topic and some (often related) subtopics.
66+
The strategy of building one none trivial application also disables us to expound
67+
all topics in the order from A to Z. But even if we cater to the practical needs
68+
of the task - each chapter has a main topic and several smaller ones, which are
69+
often related to the bigger.
6470

6571

6672
----
@@ -71,30 +77,7 @@ Each chapter has a main topic and some (often related) subtopics.
7177

7278
start with some bits
7379
main parts
74-
some bits
75-
76-
77-
if you ever wondered what Perl 6 is able
78-
to this practical Tutorial, aimed to people who learn the most while
79-
our little tutorial: "Perl 6 for problem solver".
80-
It's made for practical people. So writing working code will be the main vehicle
81-
to show you the wonderful World of this well layed out language.
82-
Theory and Perl philosophy will be taught on the fly and just enough to dive
83-
into more complicated settings without getting lost. Not much programming or
84-
computer science knowledge is therefore required, just an occasional
85-
lookup in wikipedia or a search engine.
86-
87-
88-
89-
90-
91-
> At the end of each chapter stands a working program,
92-
> which hopefully becomes useful to you.
93-
94-
95-
During the course an application
96-
It requires almost none background in programming or computer science -
97-
What it aims that filled in by quick search,
80+
some bits
9881

9982

10083

@@ -112,17 +95,25 @@ What it aims that filled in by quick search,
11295
[Perl Philosophy](#chapter-0)
11396
-----------------------------
11497

98+
keep easy
99+
hard possible
100+
TIMTOWDTI
101+
natural language
115102

116103

117104

118105
[Basic Syntax Rules](#chapter-0)
119106
--------------------------------
120107

108+
white space
109+
semicolon
110+
braces
121111

122112

123113
[First Example](#chapter-0)
124114
--------------------------
125115

116+
not explaining details
126117

127118
`use v6;`
128119

menu.md

+15-8
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,19 @@
11
#Perl 6 for problem solver
22

3-
+ [Chapter 0](/chapter/text0.md) ....... [Main Program](/chapter/bn0.pl6)
4-
+ [Chapter 1](/chapter/text1.md) ....... [Main Program](/chapter/bn1.pl6)
5-
+ [Chapter 2](/chapter/text2.md) ....... [Main Program](/chapter/bn2.pl6)
6-
+ [Chapter 3](/chapter/text3.md) ....... [Main Program](/chapter/bn3.pl6)
7-
+ [Chapter 4](/chapter/text4.md) ....... [Main Program](/chapter/bn4.pl6)
8-
+ [Chapter 5](/chapter/text5.md) ....... [Main Program](/chapter/bn5.pl6) [Notebook Module](/chapter/Notebook5.pm6)
9-
+ [Chapter 6](/chapter/text6.md) ....... [Main Program](/chapter/bn6.pl6)
10-
+ [Chapter 7](/chapter/text7.md) ....... [Main Program](/chapter/bn7.pl6)
3+
+ [Chapter 0](/chapter/text0.md) .............. [Main Program](/chapter/bn0.pl6)
4+
* [goals](/chapter/text0.md#goals) and [methods](/chapter/text0.md#teaching-method)
5+
* [layout of the whole and structure of each chapter](#chapter-layout)
6+
* [few prerequisites](/chapter/text0.md#prerequisites)
7+
* [Perl philosophy](/chapter/text0.md#perl-philosophy)
8+
* [basic syntax rules](/chapter/text0.md#basic-syntax-rules)
9+
* [first tiny example: hello math !](/chapter/text0.md#first-example)
10+
+ [Chapter 1](/chapter/text1.md) .............. [Main Program](/chapter/bn1.pl6)
11+
+ [Chapter 2](/chapter/text2.md) .............. [Main Program](/chapter/bn2.pl6)
12+
+ [Chapter 3](/chapter/text3.md) .............. [Main Program](/chapter/bn3.pl6)
13+
+ [Chapter 4](/chapter/text4.md) .............. [Main Program](/chapter/bn4.pl6)
14+
+ [Chapter 5](/chapter/text5.md) .............. [Main Program](/chapter/bn5.pl6) [Notebook Module](/chapter/Notebook5.pm6)
15+
+ [Chapter 6](/chapter/text6.md) .............. [Main Program](/chapter/bn6.pl6)
16+
+ [Chapter 7](/chapter/text7.md) .............. [Main Program](/chapter/bn7.pl6)
1117
+ Chapter 8
1218
+ Chapter 9
1319
+ Chapter 10
@@ -16,5 +22,6 @@
1622

1723

1824

25+
1926
Just click on links, clicking on headings brings you one level up.
2027

0 commit comments

Comments
 (0)