Skip to content

Commit 9075d2f

Browse files
committed
First pass edits
1 parent f1592c2 commit 9075d2f

File tree

1 file changed

+10
-12
lines changed

1 file changed

+10
-12
lines changed

contingent/contingent.markdown

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -858,8 +858,6 @@ will eventually have Contingent do for us:
858858
the graph `g` captures the inputs and consequences
859859
for the various artifacts in our project's documentation.
860860

861-
STOPPED HERE
862-
863861
## Learning Connections
864862

865863
We now have a way for Contingent
@@ -897,7 +895,7 @@ simplified input and output document formats.
897895
Our input documents will consist of a title on the first line,
898896
with the remainder of the text forming the body.
899897
Cross references will simply be source file names
900-
enclosed in back ticks,
898+
enclosed in backticks,
901899
which on output are replaced with the title
902900
from the corresponding document in the output.
903901

@@ -933,7 +931,7 @@ Now that we have some source material to work with,
933931
what functions would a Contingent-based blog builder
934932
need?
935933

936-
In the simplistic examples above,
934+
In the simple examples above,
937935
the HTML output files proceed directly from the source,
938936
but in a realistic system,
939937
turning source into markup involves several steps:
@@ -996,7 +994,7 @@ but it illustrates the interpretive responsibilities
996994
that parsers are required to carry out.
997995
Parsing in general is a very interesting subject
998996
and many books have been written
999-
either partially or completely dedicated to it.
997+
either partially or completely about it.
1000998
In a system like Sphinx,
1001999
the parser must understand the many markup tokens,
10021000
directives, and commands defined by the system,
@@ -1091,7 +1089,7 @@ We hope you enjoy it.
10911089
that transitively connects all the tasks
10921090
required to produce the output,
10931091
from reading the input file,
1094-
parsing and transforming the document,
1092+
to parsing and transforming the document,
10951093
and rendering the result:
10961094

10971095
\aosafigure[240pt]{contingent-images/figure3.png}{A task graph.}{500l.contingent.graph3}
@@ -1109,7 +1107,7 @@ Contingent can assume that it has been called —
11091107
and that its output will be used —
11101108
by the task currently at the top of the stack.
11111109
Maintaining the stack will require that several extra steps
1112-
surround the invocation of a task \ *T*:
1110+
surround the invocation of a task *T*:
11131111

11141112
1. Push *T* onto the stack.
11151113
2. Execute *T*, letting it call any other tasks it needs.
@@ -1290,8 +1288,8 @@ the <a href="tutorial.txt">Beginners Tutorial</a> first.
12901288

12911289
It worked!
12921290
From the output, we can see that
1293-
our transform substituted the docuent titles
1294-
for the directives in our source docuents,
1291+
our transform substituted the document titles
1292+
for the directives in our source documents,
12951293
indicating that Contingent was able to
12961294
discover the connections between the various tasks
12971295
needed to build our documents.
@@ -1377,7 +1375,7 @@ an algorithm which winds up being fairly easy to write in Python
13771375
through a hidden a recursive helper function.
13781376
Check out the `graphlib.py` source code for the details.
13791377

1380-
If upon detecting a change
1378+
If, upon detecting a change,
13811379
we are careful to re-run every task in the recursive consequences,
13821380
then Contingent will be able to avoid rebuilding too little.
13831381
Our second challenge, however,
@@ -1396,9 +1394,9 @@ This optimization will involve a final data structure.
13961394
We will give the `Project` a `_todo` set
13971395
with which to remember every task
13981396
for which at least one input value has changed,
1399-
and that therefore requires re-execution.
1397+
and which therefore requires re-execution.
14001398
Because only tasks in `_todo` are out-of-date,
1401-
the build process can skip running any other tasks
1399+
the build process can skip running any tasks
14021400
unless they appear there.
14031401

14041402
Again, Python’s convenient and unified design

0 commit comments

Comments
 (0)