From f58841557edcf01cc08be44fbc215d3bd41e21e8 Mon Sep 17 00:00:00 2001 From: okdistribute <633012+okdistribute@users.noreply.github.com> Date: Mon, 19 Oct 2020 21:01:22 -1000 Subject: [PATCH] fix: Put Why Choose first on the list of questions --- patterns/age-indicator.md | 10 +++++----- patterns/cautious-optimism.md | 10 +++++----- patterns/content-curators.md | 15 ++++++++------- patterns/discovery-pub.md | 8 ++++---- patterns/host-roulette.md | 8 ++++---- patterns/network-health-indicator.md | 4 ++-- patterns/paper-keys.md | 4 ++-- patterns/prioritize-backup.md | 4 ++-- patterns/protocol-agnosticism.md | 4 ++-- patterns/social-radius-slider.md | 6 ++++-- patterns/standards-marker.md | 6 ++++-- patterns/time-machine.md | 4 ++-- patterns/tombstones.md | 9 ++++----- patterns/user-identity.md | 10 +++++----- patterns/village-or-city.md | 4 ++-- patterns/visual-hash.md | 4 ++-- 16 files changed, 57 insertions(+), 53 deletions(-) diff --git a/patterns/age-indicator.md b/patterns/age-indicator.md index bf10ebc..83a4fea 100644 --- a/patterns/age-indicator.md +++ b/patterns/age-indicator.md @@ -1,3 +1,8 @@ +## Why Choose age indicator? + +Age indicator shows you information about network participants without taking +up too much space. + ## The Design Problem In a local-first world, peers may or may not be connected to the network at all @@ -15,11 +20,6 @@ Trello’s card ageing ![https://s3-us-west-2.amazonaws.com/secure.notion-static.com/0137b60b-4db4-4b2b-aaf9-f114d4a26aa5/Untitled.png](https://s3-us-west-2.amazonaws.com/secure.notion-static.com/0137b60b-4db4-4b2b-aaf9-f114d4a26aa5/Untitled.png) -## Why Choose age indicator? - -Age indicator shows you information about network participants without taking -up too much space. - ## Potential Problems with age indicator When there are multiple dimensions of aging—is it when a peer was last seen? or diff --git a/patterns/cautious-optimism.md b/patterns/cautious-optimism.md index eb7dc26..304225c 100644 --- a/patterns/cautious-optimism.md +++ b/patterns/cautious-optimism.md @@ -1,3 +1,8 @@ +## Why Choose Cautious Optimism? + +Trust is more fine-grained than a rigid protocol presumes; it can be +revoked at any moment, and is tied to human behavior. + ## The Design Problem In a centralized world, the trust model is simple: all participants have to @@ -32,11 +37,6 @@ a code-of-conduct-abiding network participant. - Secure Scuttlebutt - Mastodon -## Why Choose Cautious Optimism? - -Trust is more fine-grained than a rigid protocol presumes sometimes; it can be -revoked at any moment, and is usually tied to actual behavior. - ## Best Practice: How to Implement Cautious Optimism - Make sure that the terms and conditions of network participation are made diff --git a/patterns/content-curators.md b/patterns/content-curators.md index 0378e60..98a9bed 100644 --- a/patterns/content-curators.md +++ b/patterns/content-curators.md @@ -1,3 +1,7 @@ +## Why Choose Content Curators? + +When users need more flexibility and control over their feeds. + ## The Design Problem In a decentralized social network, people cannot (or should not) rely on centralized algorithms to view their feed. Protocols struggle to decide between @@ -14,21 +18,18 @@ Media and news organizations are the curators of content. - Are.na - Mastodon 'Who's on this instance' -## Why Choose Content Curators? - -More flexibility and control over feeds. ## Best Practices: How to Implement Content Curators? - Only place trusted and verified third parties in the role of content curators. -- Allow users to access more interesting and relevant contents and therefore fosters a stronger and meaningful relationship with their network. +- Allow users to access more interesting and relevant content and therefore fosters a stronger and meaningful relationship with their network. ## Potential Problems with Content Curators? -- Keep in mind that not all media and news organisations are necessarily good at curating contents. In addition, the majority of them might tend to have some certain biases and or positions. This means the quality and credibility of a content is crowdsourced and explicitly based on users' choice of curators. -- The level of contents relevance might vary depends on different platforms. +- Keep in mind that not all media and news organisations are necessarily good at curating content. In addition, the majority of them might tend to have some certain biases and or positions. This means the quality and credibility of a content is crowdsourced and explicitly based on users' choice of curators. +- The level of content relevance might vary depends on different platforms. ## The Take-Away -This is more of an opt-in option rather than a catch-all solution for curating contents. +This is more of an opt-in option rather than a catch-all solution for curating content. ## References and Where to Learn More diff --git a/patterns/discovery-pub.md b/patterns/discovery-pub.md index 57bfbd9..19d033d 100644 --- a/patterns/discovery-pub.md +++ b/patterns/discovery-pub.md @@ -1,3 +1,7 @@ +## Why Choose Discovery Pub? + +When your application is heavily enriched by the ability to search and discover new content (e.g., social networks). + ## The Design Problem In a centralized world, search and discovery within a service doesn't involve too many difficult decisions on the part of the user. When typing into a search box, the user trusts that the service is giving them the results they've asked for. This usually involves algorithms to display information in a way that makes sense to the user — including filtering, ranking, and selecting information intelligently. For most services, user has little-to-no choice on how this search and discovery is executed on their behalf, and if controls are offered, these options are usually buried within profile and platform settings. @@ -23,10 +27,6 @@ SSB pubs Mastodon Search -## Why Choose ... ? - -When your application is heavily enriched by the ability to search and discover new content (e.g., social networks). - ## Best Practice: How to Implement ... Allow users and services to create and share 'block' and 'allow' lists of instances, peers, or keywords that they do not want to include in search. First-time users should be able to adopt already well-known filters for abusive, fraudulent, or spam content. This is critical to prevent the 'Welcome to Hell' problem, where first-time users see a bombardment of irrelevant or harmful content. diff --git a/patterns/host-roulette.md b/patterns/host-roulette.md index 89d1629..15e89af 100644 --- a/patterns/host-roulette.md +++ b/patterns/host-roulette.md @@ -1,3 +1,7 @@ +## Why Choose Host Roulette ? + +When you want to steer the network into further distribution + ## The Design Problem In a centralized world, onboarding users to a service doesn't involve too many @@ -32,10 +36,6 @@ provider over another, randomly assign new users to a hosting provider. Nextcloud -## Why Choose Host Roulette ? - -- When you want to steer the network into further distribution - ## Best Practice: How to Implement Host Roulette - Make sure you indicate that the host was randomly chosen, e.g. write "choose diff --git a/patterns/network-health-indicator.md b/patterns/network-health-indicator.md index 2f075cf..13061be 100644 --- a/patterns/network-health-indicator.md +++ b/patterns/network-health-indicator.md @@ -1,11 +1,11 @@ +## Why Choose Network Heath Indicator? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Network Heath Indicator? - ## Best Practice: How to Implement Network Health Indicator ## Potential Problems with Network Health Indicator diff --git a/patterns/paper-keys.md b/patterns/paper-keys.md index adceb09..66313f4 100644 --- a/patterns/paper-keys.md +++ b/patterns/paper-keys.md @@ -1,11 +1,11 @@ +## Why Choose Paper Keys? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Paper Keys? - ## Best Practice: How to Implement Paper Keys ## Potential Problems with Paper Keys diff --git a/patterns/prioritize-backup.md b/patterns/prioritize-backup.md index 38ecc5d..729c500 100644 --- a/patterns/prioritize-backup.md +++ b/patterns/prioritize-backup.md @@ -1,11 +1,11 @@ +## Why Choose Prioritize Backup? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Prioritize Backup? - ## Best Practice: How to Implement Prioritize Backup ## Potential Problems with Prioritize Backup diff --git a/patterns/protocol-agnosticism.md b/patterns/protocol-agnosticism.md index 09386d1..3e731c6 100644 --- a/patterns/protocol-agnosticism.md +++ b/patterns/protocol-agnosticism.md @@ -1,11 +1,11 @@ +## Why Choose Protocol Agnosticism? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Protocol Agnosticism? - ## Best Practice: How to Implement Protocol Agnosticism ## Potential Problems with Protocol Agnosticism diff --git a/patterns/social-radius-slider.md b/patterns/social-radius-slider.md index abe094f..f9e5ee3 100644 --- a/patterns/social-radius-slider.md +++ b/patterns/social-radius-slider.md @@ -1,3 +1,7 @@ +## Why Choose Social Radius Slider? + +To more accurately reflect real-world social interactions and group dynamics. + ## The Design Problem Social networks are mentally taxing. Sometimes news from around the world is inspiring, other times it is just depressing. Sometimes you want to hear from @@ -10,8 +14,6 @@ Use a radius to indicate how "big" your circle is for today. ### Examples -## Why Choose Social Radius Slider? - ## Best Practice: How to Implement Social Radius Slider ## Potential Problems with Social Radius Slider diff --git a/patterns/standards-marker.md b/patterns/standards-marker.md index 9e92c28..6224240 100644 --- a/patterns/standards-marker.md +++ b/patterns/standards-marker.md @@ -1,13 +1,15 @@ +## Why Choose Standards Marker? + ## The Design Problem ## The Design Solution ### Examples +- .cobox +- .mapeosettings - .docx vs .pdf -## Why Choose Standards Marker? - ## Best Practice: How to Implement Standards Marker ## Potential Problems with Standards Marker diff --git a/patterns/time-machine.md b/patterns/time-machine.md index 3fb7306..17b4d7c 100644 --- a/patterns/time-machine.md +++ b/patterns/time-machine.md @@ -1,11 +1,11 @@ +## Why Choose Time Machine? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Time Machine? - ## Best Practice: How to Implement Time Machine ## Potential Problems with Time Machine diff --git a/patterns/tombstones.md b/patterns/tombstones.md index 7d593d5..e40ac62 100644 --- a/patterns/tombstones.md +++ b/patterns/tombstones.md @@ -1,3 +1,7 @@ +## Why Choose Tombstones? + +* When you want to protect the safety and privacy of user generated content. + ## The Design Problem User-generated content may be available forever on some Devices; and thus, could stay on the network somewhere forever. This is more likely the longer this content is online, as crawlers will begin to find it, copy it, and syncronize it to other people. @@ -12,7 +16,6 @@ We can encourage deletion across the network quite well by using Tombstones. ### Examples -* Mapeo ## How to best implement @@ -20,10 +23,6 @@ We can encourage deletion across the network quite well by using Tombstones. * Some clients may not respect tombstones, give users visibility into this and allow blocking replication with those clients. * Allow 'reversing' tombstones, that is, a tombstone should be a boolean value that can be turned off or on in the future. -## Why Choose Tombstones? - -* When you want to protect the safety and privacy of users. - ## Potential Problems with Tombstones * It won't always be clear that content won't be deleted immediately from the network. It can take time before the tombstone message is sent to other devices. diff --git a/patterns/user-identity.md b/patterns/user-identity.md index ca36335..38c8291 100644 --- a/patterns/user-identity.md +++ b/patterns/user-identity.md @@ -1,3 +1,8 @@ +## Why Choose Full Username? + +- When you want to enable users to freely move between providers and usernames + with ease + ## The Design Problem In a centralized world, it's assumed that other users are mediated through the @@ -42,11 +47,6 @@ Various P2P Social Profile Systems (Cabal, SSB, Textile, 3box) Matrix (p2p beta) -## Why Choose ... ? - -- When you want to enable users to freely move between providers and usernames - with ease - ## Best Practice: How to Implement ... - Users need to have strict control over when and where their id is shared. diff --git a/patterns/village-or-city.md b/patterns/village-or-city.md index 2b44e8b..ae551b5 100644 --- a/patterns/village-or-city.md +++ b/patterns/village-or-city.md @@ -1,11 +1,11 @@ +## Why Choose Village or City? + ## The Design Problem ## The Design Solution ### Examples -## Why Choose Village or City? - ## Best Practice: How to Implement Village or City ## Potential Problems with Village or City diff --git a/patterns/visual-hash.md b/patterns/visual-hash.md index 38a188a..ea1bdab 100644 --- a/patterns/visual-hash.md +++ b/patterns/visual-hash.md @@ -1,3 +1,5 @@ +## Why Choose Visual Hash? + ## The Design Problem ## The Design Solution @@ -6,8 +8,6 @@ - https://github.blog/2013-08-14-identicons/ -## Why Choose Visual Hash? - ## Best Practice: How to Implement Visual Hash ## Potential Problems with Visual Hash