Skip to content

Commit c892187

Browse files
committed
Fixed typo in explanation page
1 parent d465305 commit c892187

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

explanation.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Explanation deepens and broadens the reader's understanding of a subject. It bri
1616

1717
The concept of *reflection* is important. Reflection occurs *after* something else, and depends on something else, yet at the same time brings something new - shines a new light - on the subject matter.
1818

19-
The perspective of explanation is higher and wider than that of the other not types. It does not take the user's eye-level view, as in a how-to guide, or a close-up view of the machinery, like reference material. Its scope in each case is a topic - "an area of knowledge", that somehow has to be bounded in a reasonable, meaningful way.
19+
The perspective of explanation is higher and wider than that of the other three types. It does not take the user's eye-level view, as in a how-to guide, or a close-up view of the machinery, like reference material. Its scope in each case is a topic - "an area of knowledge", that somehow has to be bounded in a reasonable, meaningful way.
2020

2121
For the user, explanation joins things together. It's an answer to the question: *Can you tell me about ...?*
2222

@@ -42,7 +42,7 @@ understanding of that craft, and needs the explanatory material that will help w
4242
* *Conceptual guides*
4343
* *Topics*
4444

45-
The word *explanation* - and its cognates in other languages - refer to *unfolding*, the revelation of what is hidden in the folds. So explanation brings to the light things that were implicit or obscured.
45+
The word *explanation* - and its cognates in other languages - refer to *unfolding*, the revelation of what is hidden in the folds. So explanation brings to the light things that were implicit or obscured.
4646

4747
Similarly, words that mean *understanding* share roots in words meaning to hold or grasp (as in *comprehend*). That's an important part of understanding, to be able to hold something or be in possession of it. Understanding seals together the other components of our mastery of a craft, and makes it safely our own.
4848

@@ -106,7 +106,7 @@ title. For example: *About user authentication*, or *About database connection p
106106
Admit opinion and perspective
107107
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
108108

109-
Opinion might seem like a funny thing to introduce into documentation. The fact is that all human activity and knowledge is invested within opinion, with beliefs and thoughts. The reality of any human creation is rich with opinion, and that needs to be part of any understanding of it.
109+
Opinion might seem like a funny thing to introduce into documentation. The fact is that all human activity and knowledge is invested within opinion, with beliefs and thoughts. The reality of any human creation is rich with opinion, and that needs to be part of any understanding of it.
110110

111111
Similarly, any understanding comes from a perspective, a particular stand-point - which means that other perspectives and stand-points exist. **Explanation can and must consider alternatives**, counter-examples or multiple different approaches to the same question.
112112

0 commit comments

Comments
 (0)