@@ -142,8 +142,9 @@ Let's start with a couple of "_familiar_" _generic_ functions
142142#### ` empty ` the DOM
143143
144144Start by _ describing_ what the ` empty ` function _ does_ . <br />
145- This is both to clarify our _ own_ understanding as the people _ writing_
146- the code and to _ clearly communicate_ with the ** ` humans ` _ reading_ ** the code.
145+ This is both to clarify our _ own_ understanding
146+ as the people _ writing_ the code <br />
147+ and to _ clearly communicate_ with the ** ` humans ` _ reading_ ** the code.
147148
148149##### Function Description
149150
@@ -161,12 +162,13 @@ with _just_ the function description:
161162 * it is used to erase the DOM before re-rendering the app.
162163 */
163164```
164- Writing out the function documentation _ first_ helps you _ think_
165- about what the functionality is.
166- Even if you know exactly what code needs to be written,
167- resist the temptation to write the code until it is documented.
168- Always imagine that you are "_ pairing_ " with someone
169- who does _ not_ already "know the solution"
165+ Writing out the function documentation _ first_
166+ helps us _ think_ about the functionality.
167+ Even if you know _ exactly_ what code needs to be written,
168+ _ resist_ the temptation to write the code until it is documented.
169+ Even if you are writing code alone,
170+ always imagine that you are "_ pairing_ " with someone
171+ who does _ not_ (_ already_ ) "know the solution"
170172and you are _ explaining_ it to them.
171173
172174
0 commit comments