Resources

Creating a guide

⏱ 3 min

Context

Meaning-carrying tools, like handbooks or maps, can help collect content and stories as well as assist others who want to adopt the idea.

Problem

Established ideas have knowledge cartography challenges for newcomers, consider trying to decipher a subway map in a foreign city. When the idea or system is only “newly discovered”, the associated meanings may not be well understood, and indeed they may not have been created. Even if a topic is only “personally new”, it can be hard to find one’s way around.

Solution

The process of creating the guide can go hand-in-hand with figuring out how the system works. Thus, techniques of knowledge cartography and meaning making are useful for would-be guide creators.[fn:1]

Rationale

It is important to keep in mind how “the map is not the territory,” and map-making is only one facet of shared human activity. For instance, a pattern description can be thought of as a “micro-map” of a specific activity. These maps are not useful if they are divorced from practice. The process of creating a guide creates a certain formality to the project, forcing participants to catalogue and explicate their idea. Additionally, the act generally leads to deadlines which can help prod individuals to work on the project more regularly.

Resolution

Writing down this pattern clarifies the importance of creating a guide for your idea if you want others to adopt it for use.[fn:2] If people complain that they are confused, now we know why.

What’s Next

Working with our shepherd at PLoP to improve this paper![fn:3]

dashboard (image by Amanda Lyons, used with permission).

[fn:1] We started the Peeragogy project by collaboratively making an outline for the Peeragogy Handbook. We recommended this handbook-making practice to others, as a way to learn collaboratively and build a strong group.

[fn:2] As Richard Stallman wrote about free software documentation: “The biggest deficiency in free operating systems is not in the software---it is the lack of good free manuals that we can include in these systems. Many of our most important programs do not come with full manuals. Documentation is an essential part of any software package; when an important free software package does not come with a free manual, that is a major gap.”

[fn:3] Regarding connections with programming per se: we are not currently making software in the Peeragogy project, but we do continually evaluate and assemble software tools to support our activities. We often run into “bottleneck” problems; see Carrying capacity. The better we are able to exposit the problems we’re dealing with, the more likely it is that our high-level analysis (and synthesis) has the potential to inform future programming work.

⚡ Unpeeragogy

Decostruzione: Creating A Guide

⏱ 1 min unpeeragogydecostruzioneanti-pattern

Questo è lo spazio per la controparte Unpeeragogy di “Creating A Guide”. Qui la teoria viene smontata, il pattern viene decostruito, e la realtà operativa prende il sopravvento.

Failure Pattern: L’Applicazione Meccanica Prendere un pattern teorico e applicarlo senza contesto è la ricetta per il fallimento. I manuali di peeragogy insegnano strumenti, ma non insegnano a leggere il terreno. Il risultato? Gruppi che seguono il manuale alla lettera e si chiedono perché non funziona.

Agente Perturbatore: “Avete copiato il pattern, ma non avete capito perché funziona. O se funziona per voi. Copiare senza capire non è peer learning, è catechismo. Leggete meno manuali e guardate di più il vostro gruppo.”

💬 Discussione: Decostruzione: Creating A Guide

Questa discussione è ancorata al piano della realtà operativa. Niente teoria — solo esperienze, fallimenti, e verità scomode.

💬 Le discussioni sono attive su GitHub Discussions.

Disponibile quando deployato su un dominio pubblico con Giscus configurato.