docs: 📝 update some docs

Antifragility.md

@@ -4,7 +4,7 @@ Antifragility is a property of [[systems]] that increase in capability, resilien
 
 - Antifragility is beyond resilience or robustness. **The resilient resists shocks and stays the same. The antifragile gets better**.
 - [[Evolution]] is antifragile.
-	- In a stable system, animals won't evolve. In a volatile system, they will.
-	- [Just that a little bit of disorder is good](https://astralcodexten.substack.com/p/book-review-antifragile). [[Evolution]] is a system that allows volatility rather than unwisely trying to buffer against it.
-	- Being exposed to [[evolution]] sucks - animals very often die. Perhaps it would be much kinder if somebody gave unfit animals some food to prevent them from starving. But such kindness would prevent natural selection, and gradually weaken the species (or, more technically, the species' suitability to its niche) until eventual cataclysm.
+  - In a stable system, animals won't evolve. In a volatile system, they will.
+  - [A little bit of disorder is good](https://astralcodexten.substack.com/p/book-review-antifragile). [[Evolution]] is a system that allows volatility rather than unwisely trying to buffer against it.
+  - Being exposed to [[evolution]] sucks - animals very often die. Perhaps it would be much kinder if somebody gave unfit animals some food to prevent them from starving. But such kindness would prevent natural selection, and gradually weaken the species (or, more technically, the species' suitability to its niche) until eventual cataclysm.
 - [On areas with frequent catastrophes, where the catastrophes have externalities on people who didn't choose them, you want to lower variance, so that nothing ever gets bad enough to produce the catastrophe. In an area where people can choose whatever they want, and are smart enough to choose good things rather than bad ones, you want to raise variance, so that the best thing will be very good indeed, and then everybody can choose that and bask in its goodness](https://astralcodexten.substack.com/p/more-antifragile-diversity-libertarianism).

Asking Questions.md

@@ -3,10 +3,10 @@
 ![[Quotes#^c63c02]]
 
 - [Ask smart questions](http://www.catb.org/esr/faqs/smart-questions.html):
-	1. Do your own research first.
-	2. Provide useful context up-front. Include things you have tried and thought of before asking the question.
-	3. Be explicit about what you want to achieve in the end and provide as much up-front information as possible to help.
-	4. Respect other people's [[time]]. Follow up after you get an answer.
+  1. Do your own research first.
+  2. Provide useful context up-front. Include things you have tried and thought of before asking the question.
+  3. Be explicit about what you want to achieve in the end and provide as much up-front information as possible to help.
+  4. Respect other people's [[time]]. Follow up after you get an answer.
 - [When asking for help, let the people know what the problem you are trying to solve actually is instead of simply saying your solution and the reader guessing what it is you are actually trying to do](http://xyproblem.info/).
 - [Think about the question like a child](https://www.aaronkharris.com/asking-questions).
 - The most simple, seemingly silly questions are almost always profound.

Asynchronous Communications.md

@@ -3,18 +3,18 @@
 - Having [asynchronous communication channels and making heavy use of them can have great effects on productivity](https://www.martinklepsch.org/posts/asynchronous-communication.html).
 - Every question asked in an internal Slack is a policy failure.
 - [Asynchronous environments allows for self discovery without interruptions](https://snir.dev/blog/remote-async-communication/):
-	- You can keep on your flow without waiting for someone to give you details.
-	- You can get into "Deep [[Focus]]" session without context switching that allows for better [[productivity]].
-	- You can work whenever, since you are not dependent on anyone immediately.
-	- You'll have written records of everything.
+  - You can keep on your flow without waiting for someone to give you details.
+  - You can get into "Deep [[Focus]]" session without context switching that allows for better [[productivity]].
+  - You can work whenever, since you are not dependent on anyone immediately.
+  - You'll have written records of everything.
 - [Async communication](https://protocol.almanac.io/docs/async-work-ezPny9x7Q50QISL4UIUhB3PoURV0lgxP) takes more time but it enable better thinking. Learn to [[Asking Questions |ask better questions]] and [[Writing |write requests]].
 - The 4 components of a [great asynchronous message](https://protocol-labs.gitbook.io/launchpad-curriculum/launchpad-learning-resources/protocol-labs-network/os-stewardship#sync-comms):
-	1. Enough information to cover all follow-up questions.
-	2. A deadline. When do you need a response by? How urgent is it? Which task is being blocked right now?
-	3. Links, images, and as much supporting material as possible that will help illustrate your thoughts.
-	4. A concrete need. What do you want to get out of the communication? Approval on a task? An asset of some kind? Be clear.
+  1. Enough information to cover all follow-up questions.
+  2. A deadline. When do you need a response by? How urgent is it? Which task is being blocked right now?
+  3. Links, images, and as much supporting material as possible that will help illustrate your thoughts.
+  4. A concrete need. What do you want to get out of the communication? Approval on a task? An asset of some kind? Be clear.
 - Beware of the (cultural) Power Distance Index. The lower the PDI, the more direct communications are preferred; the higher, the more diplomatic the communications are preferred.
 
 ## Resources
 
--  [Manifesto for Async Software Development](http://asyncmanifesto.org/)
+- [Manifesto for Async Software Development](http://asyncmanifesto.org/).

Automation.md

@@ -1,12 +1,12 @@
 # Automation
 
 - Aim for automating all your job. [A good way is to start writing a script that only prints out the steps required to do a task](https://blog.danslimmon.com/2019/07/15/do-nothing-scripting-the-key-to-gradual-automation/). You can replace these steps one by one and do the rest manually until they're all automated.
-	- [Not everything should be automated right away](https://xkcd.com/974/).
-	- [Fake it, until you automate it!](https://understandlegacycode.com/blog/fake-it-until-you-automate-it/)
+  - [Not everything should be automated right away](https://xkcd.com/974/).
+  - [Fake it, until you automate it!](https://understandlegacycode.com/blog/fake-it-until-you-automate-it/)
 - Automation is used for Precision, Stability and Speed. It reduce or eliminate human error and brings stability to a system. [Automation is great when it replaces a stable, well-working manual process](https://news.ycombinator.com/item?id=30230367).
-- [Automation is putting process into code](https://queue.acm.org/detail.cfm?id=3197520).
-	1. Document the steps. Following a step-by-step guide is automation: you are the CPU. A great starting point is adding a [[checklist]] to PRs.
-	2. Create automation equivalents. Add command-line snippets to replace steps.
-	3. Create automation. Create a script that runs everything.
+- [Automation is putting process into code](https://queue.acm.org/detail.cfm?id=3197520):
+  1. Document the steps. Following a step-by-step guide is automation: you are the CPU. A great starting point is adding a [[checklist]] to PRs.
+  2. Create automation equivalents. Add command-line snippets to replace steps.
+  3. Create automation. Create a script that runs everything.
 - Drive standards through automation and building internal tools/scripts rather than through extensive [[documentation]].
 - Makefiles are a great way to document and consolidate different projects of a team. Each project should have a `make` that runs it, and perhaps a `make deploy` to deploy it. Language and tool independent!

Blogging.md

@@ -10,21 +10,21 @@
 - Start with Why. Start with a question. Write the first flawed answer that comes to mind. Write the first question or objection that comes to mind from that answer. Write the first response that comes to mind from that, ...
 - [Writing creates a cache](https://twitter.com/eugeneyan/status/1256828203840073728). The cache (i.e., documents) scales data availability. people can access the cache instead of going to you.
 - [Expand your definition of completing a project (any project, no matter how small) to include writing a blog post that explains that project](https://twitter.com/simonw/status/1578018383127187461f).
-- For long-form content, the [diamond model](https://dropbox.design/article/mental-models-for-designers) works great for putting a structure around your main idea.
-	1. Attention: Start with a story, statistic, or something similar
-	2. Main topic: Briefly introduce the main topic you'll cover
-	3. Previews: Give quick previews of your subtopics
-	4. Subtopics: Go into depth with your subtopics
-	5. Summaries: Recap your subtopics
-	6. Conclusion: Paint an ideal vision of the future
-	7. Call to action: Invite your audience to act or make a decision
+- For long-form content, the [diamond model](https://dropbox.design/article/mental-models-for-designers) works great for putting a structure around your main idea:
+  1. Attention: Start with a story, statistic, or something similar
+  2. Main topic: Briefly introduce the main topic you'll cover
+  3. Previews: Give quick previews of your subtopics
+  4. Subtopics: Go into depth with your subtopics
+  5. Summaries: Recap your subtopics
+  6. Conclusion: Paint an ideal vision of the future
+  7. Call to action: Invite your audience to act or make a decision
 - For [short-form content](https://sivers.org/7):
-	1. Write all your thoughts on a subject.
-	2. Argue against those ideas.
-	3. Explore different angles.
-	4. Leave it for a few days or years, then repeat those steps.
-	5. Hate how messy these thoughts have become.
-	6. Reduce them to a tiny outline of the key points.
-	7. Post the outline. Trash the rest.
+  1. Write all your thoughts on a subject.
+  2. Argue against those ideas.
+  3. Explore different angles.
+  4. Leave it for a few days or years, then repeat those steps.
+  5. Hate how messy these thoughts have become.
+  6. Reduce them to a tiny outline of the key points.
+  7. Post the outline. Trash the rest.
 - Reading is the inhale, writing is the exhale. Breathe.
 - The more you create, the more ideas come yo you to continue creating. That's the creativity [[Feedback Loops |feedback loop]].

Coordination.md

@@ -21,6 +21,7 @@
 - If we imagine human society as it's own organism. We need processes and other coordination tools to make it remove the hand from the fire when it starts to burn.
   - The hand doesn't know what to do, but relies information to the brain, that makes the appropriate changes.
   - Something similar could be achieved at a society level, where pain triggers processes that make it stop.
+- Only a few bits of information are possible to reliably convey to a large number of people. [The larger the group, the smaller the message needs to be](https://www.lesswrong.com/posts/4ZvJab25tDebB8FGE/you-get-about-five-words).
 - The requirements to govern a commons without tragedy:
   - Clear boundaries.
   - Managed by locals.

Culture.md

@@ -4,6 +4,6 @@
 
 - It is _very_ difficult to undo bad culture — far more than it is to shape good culture. So it's best to avoid it altogether. You have to constantly be on the lookout for nascent bad behavior, in order to nip it in the bud before it becomes too bad.
 - A bad thing to do to the culture is introduce too much tension:
-	- There are better battles to fight than with each other.
-	- It's hard to say objectively that one culture is "better" than another, but having the culture pulled in multiple directions clearly burns people out, so focus on cultural alignment in decisions and hiring.
+  - There are better battles to fight than with each other.
+  - It's hard to say objectively that one culture is "better" than another, but having the culture pulled in multiple directions clearly burns people out, so focus on cultural alignment in decisions and hiring.
 - Times change, trends change, cultures change.

Data/Experimentation.md

@@ -18,7 +18,7 @@ We do not live in an ideal world, so we need to be very deliberate and thoughtfu
 - Do not simply copy what other companies are doing (do not assume that other companies tested and validated something).
 - Choose one primary metric in advance to determine "winner" while keeping a few guardrail metrics.
 - [You're probably **not measuring what you thought you were measuring**](https://www.lesswrong.com/posts/9kNxhKWvixtKW5anS/you-are-not-measuring-what-you-think-you-are-measuring). But if you measure enough different stuff, you might figure out what you’re actually measuring.
-	- Log generously.
+  - Log generously.
 - Stack rank all ideas based on level of effort and potential impact -- also required sample size/run time to get results.
 - Continuously validate tracking implementation.
 - Think carefully when choosing your randomization unit.
@@ -32,20 +32,20 @@ You can use [online calculators](http://experimentcalculator.com/) to estimate t
 ### Experiment Template
 
 - Experiment summary:
-	- We believe that... {describe your hypothesis in one sentence}.
-	- To verify that, we will... {describe your test in one sentence}.
-	- And we’ll measure the impact on... {metrics}.
+  - We believe that... {describe your hypothesis in one sentence}.
+  - To verify that, we will... {describe your test in one sentence}.
+  - And we’ll measure the impact on... {metrics}.
 - Hypothesis. What are we expecting to happen? What can we monitor to detect problems with this?
 - Business problem
 - Supporting data
 - Required tracking
 - [Expected outcome](https://about.gitlab.com/handbook/business-technology/data-team/experimentation-best-practices/):
-	- Define the primary metric that we want the experimentation to move. This is the metric we use to define the rollout scenario.
-	- Define the secondary metric(s): There are metrics that help us validate and understand in detail why and how the primary metric was impacted-
-	- Define Guardrail metrics: This helps us ensure we are not harming the business in the long run for short-term gains.
+  - Define the primary metric that we want the experimentation to move. This is the metric we use to define the rollout scenario.
+  - Define the secondary metric(s): There are metrics that help us validate and understand in detail why and how the primary metric was impacted-
+  - Define Guardrail metrics: This helps us ensure we are not harming the business in the long run for short-term gains.
 - Experiment design & implementation
-	- Rollout plan
-	- Implementation Checklist (docs are present, tested on staging, marketing coordination, ...)
+  - Rollout plan
+  - Implementation [[Checklist]] (docs are present, tested on staging, marketing coordination, ...)
 - Known Assumptions
 
 ## Experimentation Mindset

Focus.md

@@ -2,11 +2,11 @@
 
 [Focus (absorption, concentration) is the ability to narrow the attention so as to apply it in a more detailed and penetrating way for sustained periods of time on some chosen part of your present experience](https://www.lesswrong.com/s/xqgwpmwDYsn8osoje/p/35eEHAXis3jMqETod).
 
-- Whatever your primary motivations are in life, you won't get anywhere by waiting for something to happen. Plan!
-  - Humans do not think [[Thinking |strategically]] by default.
+- Whatever your primary motivations are in life, you won't get anywhere by waiting for something to happen. Plan! It'll never be the right time.
+  - Humans do not think [[Thinking|strategically]] by default.
 - Environmental changes can make it easier to attend effectively to the right things.
   - Removing clutter and other distractions can make attention less difficult, for which the virtues of orderliness and simplicity can help.
   - Disable notifications and badges so that you don't mindlessly open distracting apps.
-- [[Mental Health#Meditation |Mindfulness meditation]], e.g. breath-counting, seems to be a go-to technique for developing focus.
+- [[Meditation|Mindfulness meditation]], e.g. breath-counting, seems to be a go-to technique for developing focus.
 - Periodic exposure to nature and out-of-doors in an relaxing, undemanding way can restore attention capability.
 - [Attention is a scarce resource](https://youtu.be/ZWI4_Oe-Qbs). Everything in the world is fighting to get yours.

Gardening.md

@@ -2,7 +2,7 @@
 
 - Know your soil. Understanding the type of soil in your garden is crucial to determining which plants will thrive, and which won't.
 - Use a watering can or a soaker hose to deliver water directly to the roots, and avoid getting the leaves wet.
-- Soak weeds in a container to extract nutrient. Water your plants with that every now and then.
+- Soak weeds in a container to extract nutrient. Water your plants with that every now and then. If it looks sad, it needs water (a good rule for houseplants and humans).
 
 ## Resources
 

House Buying.md → House.md

@@ -1,21 +1,25 @@
-# House Buying
+# House
 
-- Be clear about why you're buying a home. Every large [[Making Decisions |decision]] you have to make about home ownership should somewhat tie in to this.
-- Look at houses based on the life style you have not the life style you aspire to have.
 - [Living in the same place as the people you love matters](https://waitbutwhy.com/2015/12/the-tail-end.html).
+- As with many other things, there are [patterns that will help you structure it](http://www.architectureweek.com/topics/patterns.html).
+
+## Buying
+
+- Be clear about why you're buying a home. Every large [[Making Decisions|decision]] you have to make about home ownership should somewhat tie in to this.
+- Look at houses based on the life style you have not the life style you aspire to have.
 - Balance commuting against other goods and costs (Commuting Paradox).
 - The availability heuristic says that people over count scenarios that are easy and vivid to imagine, and under count scenarios that don't involve any readily available examples or mental images. The real estate version of this fallacy involves exciting opportunities that you will rarely or never use. For example, a house with a pool may bring to mind the opportunity to hold pool parties. But most such plans will probably fall victim to akrasia, and even if they don't, how often can one person throw pool parties without exhausting their friends' interest? Pool parties may be fun to imagine, but they'll probably only affect a few hours every couple of months. Other factors, like the commuting distance and whether your children end up in a nice school, may affect several hours every day.
 - Good illumination (daylight has a strong effect on mood) and a view of natural beauty (nature increases mental functioning and concentration) aren't just pleasant luxuries, but can make important practical differences in your [[Health]]. Light and plants make a difference.
   - Aim for a small sunny place in the winter!
 - Research nearby future facilities. Schools, shopping malls, coffee shops, transportation, ...
 - Check the electrical and water installations of the building.
-- Treat it as a [[Finances |finance]] asset. Think for how much it'll sell.
+- Treat it as a [[Finances|finance]] asset. Think for how much it'll sell.
 
-## Mortgage
+### Mortgage
 
 - Aim for the minimum links with the bank.
 
-## Resources
+### Resources
 
 - [Mi Casa Modular](https://micasamodular.com/)
   - [Related tweet with some extra resources](https://twitter.com/dsaltaren/status/1346173582959927296).