summary Monday 03 February 2020 - live editing session

[Joe Corneli]

We edited the introduction.md on https://floobits.com/Peeragogy/Handbook/file/introduction.md:1 -- mainly *moving* the "Scrapbook of Peeragogical Problems" that can be found on http://peeragogy.github.io/introduction.html into the "Scrapbook" pattern (for now).  This addresses a point raised repeatedly in the Reading Group sessions: that the introduction to the handbook is too much about "us" and not enough about the reader.  We still need to do more work to make the introduction *useful* to readers, but work is now in progress.

Ideally the first page itself would be practical in the sense "If you learn nothing else, what is one thing you can learn and use right away?"

I recall Nico asking about the one-liner gems of Peeragogy, so we could revisit that theme and include some of these findings here in the early pages of the book.

In the meeting we also came up with a plan of action to revise the introduction further:

We will use the existing summaries to write a summary of the whole book
 - https://docs.google.com/document/d/1Zcsuvmky5cQmWlglO6lK1HYWsGR3xwlMePls-klLNZg/edit

(Charlotte leading)

We will write a short version of the handbook, following the revised outline, building on the "starter pack" that Charlie initiated (Joe leading for now)

- https://docs.google.com/document/d/1w2JZhpkrYYKknpJSSJgz23PPYxI31Cu1eWvw8I9ZraM/edit#heading=h.m04zfefgpa67

-  We will add a list of translations and other highlights of our work so far directly to introduction.md (Charlie leading)

- We will make a more detailed updated survey of papers and other sources that use peeragogy, so that we can include pointers to the in the literature (Ray intends to contribute to this but he has limited time over the next month so this could be a good opportunity for others who would like to jump in)

- https://docs.google.com/document/d/1W6AmH4mbXE63ombzVj7biyjrUpLgpGTlUi-bvKiyx6I/edit

TECH NOTE

I installed floomatic following instructions here: https://floobits.com/help/floomatic

... and synced the changes locally:

$ floomatic --join https://floobits.com/Peeragogy/Handbook --read-only
⚠️   WARN 2020-02-05 20:34:07 +0000 No native-diff-match-patch. You won't be able to patch binary files.
▪️    LOG 2020-02-05 20:34:07 +0000 Joining workspace https://floobits.com/Peeragogy/Handbook
▪️    LOG 2020-02-05 20:34:07 +0000 Reloading hooks.
▪️    LOG 2020-02-05 20:34:07 +0000 Didn't find any hooks in .floo.
▪️    LOG 2020-02-05 20:34:07 +0000 Watching /home/joe/PeeragogyFloobits/.floo for changes
▪️    LOG 2020-02-05 20:34:11 +0000 starting syncing
▪️    LOG 2020-02-05 20:34:11 +0000 buf action.md md5 sum mismatch. re-fetching... d48c252275ffb92e960aedd776498dd0 4129dd7ad5d737ea67e22076177bc6d1
▪️    LOG 2020-02-05 20:34:11 +0000 buf introduction.md md5 sum mismatch. re-fetching... 6634a88ac8485b7a83af2f8b2ecf4318 ada6953e3760e215863f795a0cce097f
▪️    LOG 2020-02-05 20:34:11 +0000 buf participation.md md5 sum mismatch. re-fetching... 03b2e1d9722d1a87b0d744d03463614d 9cd64670ffa819d61bd38bd70b0f8cde
▪️    LOG 2020-02-05 20:34:11 +0000 buf pattern-scrapbook.md md5 sum mismatch. re-fetching... a9345d92d9ebfb9e98415e46dffa5d08 09ce140a60bf2b6510e756488bb9fa6d
▪️    LOG 2020-02-05 20:34:11 +0000 all done syncing
▪️    LOG 2020-02-05 20:34:11 +0000 Not opening browser because you don't have permission to write to this workspace.
▪️    LOG 2020-02-05 20:34:12 +0000 Writing action.md
▪️    LOG 2020-02-05 20:34:12 +0000 Writing introduction.md
▪️    LOG 2020-02-05 20:34:12 +0000 Writing participation.md
▪️    LOG 2020-02-05 20:34:12 +0000 Writing pattern-scrapbook.md

 I haven't committed them to Github because we should probably be doing our edits in a fork, and submitting pull requests when we have things ready.

TECH TODO:

Let's set up a fork of Peeragogy.github.io that we can use for staging changes.