swyxio / swyxdotio

This is the repo for swyx's blog - Blog content is created in github issues, then posted on swyx.io as blog pages! Comment/watch to follow along my blog within GitHub
https://swyx.io
MIT License
341 stars 45 forks source link

Digital Garden Terms of Service #387

Closed swyxio closed 2 years ago

swyxio commented 2 years ago

source: devto devToUrl: "https://dev.to/swyx/digital-garden-terms-of-service-ljd" devToReactions: 11 devToReadingTime: 6 devToPublishedAt: "2020-02-26T07:56:56.769Z" devToViewsCount: 275 title: Digital Garden Terms of Service published: true description: This is my attempt to explicitly define a not-legally-binding "terms of service" for people who peruse Digital Gardens, and the people who Learn in Public with them. category: essay tags: Writing, Learn in Public, Second Brain slug: digital-garden-tos date: 2020-02-25 disclosure: Interested in this as an experiment for myself, but happy to change, add, or prune over time. Have had this in my head a while, but mostly wrote this on a flight.

This is my attempt to explicitly define a not-legally-binding "terms of service" for people who peruse Digital Gardens, and the people who Learn in Public with them.

image

Table of Contents

Why We Need a Terms of Service

The Learn In Public movement has encouraged thousands of people to write, speak, draw, or otherwise pick up what mentors put down, with the end goal of lifelong L(N*P) growth in personal knowledge and network. A key part of this strategy is maintaining your own Digital Garden.

A Digital Garden is your very own place (often a blog, or twitter account) to plant incomplete thoughts and disorganized notes in public - the idea being that these are evergreen things that grow as your learning does, warmed by constant attention and fueled by the unambiguous daylight of peer review.

It is in part a trick for creators to play on themselves: For perfectionists who stress over shipping anything less-than-polished and therefore never ship anything, it is a license to trade off self review for peer review and increased velocity. Many report both improved quality and quantity of output after giving themselves the permission to do this.

Potential Problems with Digital Gardens

However, the social contract is not explicit, which causes understandable conflict because this is such a fringe movement.

Quite simply, nobody wants the Learn In Public movement to encourage a flood of overnight experts and blogspam in a content race to the bottom. However, we also don't want to discourage learners from learning.

Safe Space for Gardeners

People with audiences do of course have some obligation to not do them a disservice, else they don't deserve that audience. However this doesn't mean that they must do exhaustive due diligence and be authoritative in every context - there needs to be space to experiment, grow, and quite frankly, be ignorant and wrong.

This need also extends to people who don't have a large audience. Even here, the social contract also needs to be more explicit. Often, people just getting started don't get the feedback they need. Experts can be very polite - they might see someone making a mistake, but not comment, because they don't want to embarrass the beginner or because unsolicited criticism can be rude.

If you keep your ego small, you can learn more by explicitly inviting people to criticise your work. You can even encourage feedback by proving that you are coachable - having a track record of acting upon feedback, correcting our notes and then following up by more clearly articulating what you got wrong for benefit of fellow beginners. This incentivises feedback by amplifying the expert's time invested in you, aided by the one thing you have that they don't: the beginner's mind.


Link to GitHub Repo

Here's the Digital Garden Terms of Service in a GitHub Repo. Please feel free to suggest changes or fork to your liking.

image

For Visitors

Welcome! You are now browsing a Digital Garden. This is my personal space for Learning In Public. I am a lifelong learner so everything is a Work-In-Progress like me, but I do not let perfectionism get in the way. That means that what you read here is not authoritative or complete, and is not representative of my best work.

However, it is representative of my interests and current state of knowledge, and if you have the same interests, then this space is also yours to use as a reference. Feedback and social sharing is welcome - that is the whole point of being public!

1. Right to Be Wrong

I have a right to be wrong or incomplete in my Digital Garden, either due to paucity of time or knowledge. You will not hold this, or my readership, against me because I will keep learning, with your help. Everything in the Digital Garden is a living document and I will retract or rephrase things I no longer agree with.

2. Constructive Criticism

You are expressly welcome to comment on, tear apart, counter-argue, or outright disagree on anything here. No compliment sandwich needed - I learn most from critics. I will listen to you but I don't promise to agree with you. Please also suggest what else I should include, read, watch, or listen to, or tell me what you would have written instead.

Better yet, write a better version of what I did and publish it on your own Garden. I'd love to read it.

3. Attribute, don't Plagiarize

Don't plagiarize. You're welcome to quote, with attribution and a link back here. I don't waive copyright for commercial purposes. But feel free to share ideas and riff off of them.


For Gardeners

Congratulations! You are now the proud owner of your own corner of the Internet. This is a second brain that exists outside your natural one - it is very good at remembering everything, searching and organizing facts and links, and saving you keystrokes. Your second brain is fertile ground: If you tend to it well, your Digital Garden will help you be a lifelong learner, catch you friends while you sleep, and bear fruits in unexpected ways.

However there are some ground rules to being a responsible Digital Gardener, and some things you can do to increase the yield on your work.

1. Consideration of Others

2. Epistemic Disclosure

In the spirit of this, the practice of disclosing epistemic status and effort originates from Devon Zuegel. I don't think this always needs be disclosed, for example if it is obvious from context. But it never hurts.

3. Response to Feedback


Call to Action

Let us all adopt more explicit Digital Garden terms of service, and wear them proudly on our garden gates, and in so doing help a thousand Digital Gardens bloom all around the world by encouraging bold, curious, prolific gardeners, while responsibly inviting visitors to co-create and cross pollinate ideas.

With clearer boundaries there will hopefully be less infighting, more personal growth, and more great ideas - the oxygen on which our whole world relies for Progress.

CozyCheri commented 3 weeks ago

I love this so much!!