From 81d50ec1a78a16f17434e5a5472ea609e422920f Mon Sep 17 00:00:00 2001 From: km0 Date: Tue, 25 Apr 2023 11:59:54 +0200 Subject: [PATCH] 03 pair --- 03/index.html | 43 +++++++++++++++++++++++++++++++++++++++++++ index.html | 15 +++++++++++---- notes.md | 0 3 files changed, 54 insertions(+), 4 deletions(-) create mode 100644 03/index.html create mode 100644 notes.md diff --git a/03/index.html b/03/index.html new file mode 100644 index 0000000..816a67a --- /dev/null +++ b/03/index.html @@ -0,0 +1,43 @@ + + + + + 03 - Pair + + + +
+

doc doc doc

+
documenting code documentation
+
hello! welcome. this is an archive to navigate trough documentation practices
+
pair programming and pair reading.
+
+ + +
+
+ +

+ The practice of pair programming involves two developers coding together on the same machine, with distinct roles. The driver writes the actual code, while the navigator reviews each entry along the way. + Roles are often switched. + Developers with similar or different experience can collaborate in pair programming, with benefits for both parts. +

+ +

+ Could the concept of pair programming be applied to documentation? +

+ +

pair documentation writing: one writes and the other provides perspective, such as reviewing if there are parts that are not clear

+

pair documentation reading: one read and the other ???

+ +

experiments with pair doc writing together with chae for the flask example repo, that led to a more welcoming and vernacular way of writing

+ + +

what could it mean to read documentation in pair?

+ +
+
+ + + + diff --git a/index.html b/index.html index b69890b..8fe00fe 100644 --- a/index.html +++ b/index.html @@ -26,6 +26,8 @@ there is no clear path / a practice to learn / shared practice personal practice + + @@ -51,10 +53,10 @@ @@ -67,6 +69,11 @@ diff --git a/notes.md b/notes.md new file mode 100644 index 0000000..e69de29