[[Knowledge Management]], [[Reproducible [[Social [[Science]]]]]], and [[Academic Workflow]]s โ 100 Tweets for @threadapalooza 2020, let's go #roamcult#๐
1/100
Pandoc is a magical piece of software, and if you're not using it for your academic writing you're missing out. Compile (basically) any document format to (basically) any other document format.
2/100
While Pandoc is fantastic, it's a bit like ffmpeg: extremely powerful, but without GUI apps too few people will use it. ffmpeg has a ton of GUI apps that basically just wrap the CLI, Pandoc doesn't have enough of them.
3/100
Citekeys + CSL files + Pandoc can easily cut ~10+ hours from your writing workflow. Citekeys come from LaTeX-Land, you can use them through Pandoc with anything. And CSL files make it super easy to switch citation styles.
4/100
Since many journals have their own version of popular formats, every journal should be required to publish a CSL file, LaTeX and Word Pandoc template ready for submission. I don't want to think about the collective hours wasted formatting stuff for submission.
5/100
Why Pandoc you ask? The one true document format are text files. Lindy effect - they've been around from the beginning, they will be around until the end. Everything else can be created from them โ so write your stuff in text files, then use Pandoc.
6/100
"That contradicts your devotion to @RoamResearch!" Yeah, no. If Roam had shitty plain-text export like Evernote, sure. But I can get stuff easily as Markdown (plain text), so I lose nothing and gain a world of features. Use Roam, export to Markdown, publish w/ Pandoc.
7/100
Citekeys are powerful because they are unique ids for whole papers. And unlike DOIs they are _memorable_. citekey:doi = domain:ip
Think in terms of Roam, papers should have unique IDs for paragraphs, so I can do einstein1905movement/ASDJKSL to link to a specific paragraph
8/100
PDFs are a horrible format and should die in a fire. I don't know enough about document formats, but I know there are better ones out there that give the illusion of "uneditable" and that PDFs suck. But Lindy strikes again: we're stuck with them, I fear.
9/100
Talking about "permanence", I feel there's a lot of tension to be resolved around the question of "what do we actually know right now in this particular subfield"? The more we move to pre-prints and "public peer review", the less legible fields become, bc volume increases.
10/100
At least in the social sciences, there is way to much emphasis on "contributing to theory". I've received and seen others receive too much feedback along the lines of "this doesn't contribute much to theory". We need to falsify more, not introduce endless mods to theory.
11/100
Avoid High Modernist Design in your Knowledge Base
Whether you're using @tana_inc, Notion, or any other tool to manage knowledge and collaborate โ that's the one thing you want to avoid.
Let me tell you what I mean: ๐งต
What is "High Modernism"?
It's a term from James Scott's fantastic book "Seeing Like A State" and describes, slightly condensing,
"uncritical optimism about comprehensive planning."
It's been applied to everything from forestry to city planning โ and you should avoid it.
So what does it have to do with team knowledge bases?
When we decide to create a system to document things, to build a wiki, to collaborate, it's very easy to start by _designing_ such a system from scratch.
1) Work in 2h blocks 2) Use noise cancelling headphones 3) Use 4) Interstitial Journaling 5) Rapid Feedback
Some more detail:
1) Work in 2h blocks
I did this way before Huberman taught me about ultradian cycles, but apparently our brain doesn't just cycle through 1.5h long periods while we sleep, but also while we are awake.
So what I do is the following (starting at top of hour for ease of demonstration):
08:00 โ Plan: what am I going to focus on, what's the goal? How am I doing, any interruptions I need to expect? How will I handle them?
08:10 โ Work for 30min
08:40 โ 5min break: stand up, look around, stretch, refocus: where do I move my focus next?
08:45 โ Work for 30min
09:15 โ 5min break: stand up, look around, stretch, refocus: where do I move my focus next?
09:20 โ Work for 30min
09:50 โ Review: how did this round go? What did I get done? Anything I can do better? Move, take a short break.
Ready to go again at 10:00
I've done full 8-12h days like this, but often even a single 2h cycle gets me deep enough into the zone that I stop following the template until I physically can't anymore or am interrupted.
Also works at the end of the day to get that one more rep in.
2) Noise cancelling headphones are amazing for focus even without any music in them.
3) is magic I don't understand but use liberally. Best with noise cancelling headphones
4) Interstitial Journalling
This is what I do during my 2h sessions and esp. the breaks: plan/review/refocus in writing so that you a) can think better and b) have a record you can go through later. Flows directly into
5) Using this approach gives you a rapid feedback cycle in 30min and 2h chunks. If you do this for a week, you're going to learn A LOT about how you work, what the most common interruptions and friction points are, and how you can eliminate them.
Additional notes:
This obviously works best with a maker schedule and less well with a manager schedule. If your whole day is meetings and you don't have interruption-free 2h blocks that's not great.
This is not something to slavishly adhere to for the sake of following the template/program. I start a coding/reading/writing session like this, but I'm not forcing myself to stop if I'm deep in the zone.
This is great for learning scoping: you usually vastly overestimate what you can get done in 30min. After doing this for a while you'll get a very intuitive sense for how long certain tasks take you.brain.fm
Back in the day when I worked for Ultraworking we used to teach this as "Work Cycles" and the results people got from it were really, really good.
We also used to host "Work Marathons", a three day event where you'd try to pack as much focused work into the 72h as possible (without compromising on sleep). People regularly worked three 12h days and got a LOT of work done.
Now Ultraworking doesn't exist anymore as far as I know, but their website and template for doing "Work Cycles" are still up:
I've also done a video on how I've set this up in Tana from a year ago (man, how time flies):
"No two kitchens are the same, therefore you need to build your kitchen cabinets from scratch yourself" - @fortelabs on Second Brain templates (paraphrased)
That's basically what Tiago wrote in a newsletter he sent out yesterday
Now of course I'm biased, but here's what I think
OF COURSE you need to modify any template to fit it exactly to your needs. Even a big, encompassing template like Tanarian Brain isn't going to work 100% perfect out of the box for you.
And everyone who's bought it knows and expects that.
That's why Tanarian Brain comes with
A) loads of videos to show you how it works so you can modify it and
B) an active support community where people discuss their modifications and you can ask for help
The biggest unacknowledged problem for proponents of the Zettelkasten method as a tool for writing is that its inventor, Niklas Luhmann, is famous for how badly he wrote.
I still believe a Zettelkasten is fantastic tool, but only if you learn how to go from non-linear to linear.
This is a much better linearization of Luhmann's ideas (well, some of them, at least) than Luhmann has ever produced himself:
This is also, I believe, a reason why shareable knowledge graphs (so a published Roam Graph or a published Tana workspace) are ONLY useful when they contain some form of linearization of the material presented in the graph.
In Tana you can link from any node to any other node in your workspace very easily. You type @ and then search for the node you want to link to.
But sometimes "transcluding" the full text isn't what you want!
That's where alias links come in.
Sometimes you don't want to have the whole text there, however: our example reads very weirdly at the moment.
What we want instead is something like "As Hamlet has remarked" and have the "has remarked" link to the "To be" node.
Here's how the finished product will look like:
To do this, we use what Tana calls an "alias" โ it keeps the link, but changes the text that we see.
Select the "transclusion" (i.e. the "To be, or not to be,..." behind "As Hamlet") and then type Cmd/Ctrl+k. Then search for "alias" and select "Set alias to".