From ab5ed1002a9323113014e50157e400ea1e817aa1 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:06:55 -0400 Subject: [PATCH 1/7] change post date --- content/posts/the-gallery-and-the-toolbox/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md index 44428ca..e5ad1c1 100644 --- a/content/posts/the-gallery-and-the-toolbox/index.md +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -3,7 +3,7 @@ draft: true title: "The Gallery and the Toolbox" aliases: ["The Gallery and the Toolbox"] series: [] -date: "2024-04-24" +date: "2024-07-08" author: "Nick Dumas" cover: "" keywords: ["", ""] From e96a0e4fe34a1d04f23c56bf0f4bb0e6dd0e2283 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:24:06 -0400 Subject: [PATCH 2/7] testing a blank header --- .../posts/the-gallery-and-the-toolbox/index.md | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md index e5ad1c1..c3819ca 100644 --- a/content/posts/the-gallery-and-the-toolbox/index.md +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -36,10 +36,26 @@ Take your favorite note. Maybe it's a recipe or a really astute observation you Is it stored in a binder, a safe, or taped to the wall above a work-area? Is it framed on the wall so that you or guests can admire or discuss it? Is this note laminated, perforated or punched, or folded in some way to make storage and retrieval easier? +Is it in a frame, or is it in a toolbox? + ## The Gallery and the Toolbox I believe that, broadly speaking, visualizations will fall into one of two classes: the toolbox and the gallery. There's no small amount of overlap here, but I do think it's possible to generally narrow down a *primary* "type" or "use" of a given work or object. ### The Gallery +A gallery is a space where you don't have a concrete "deliverable" goal, but you want to collect things that have meaning. This could be a collection of porcelain miniatures, your favorite inspirational quotes, or a bunch of pictures of possums. The primary analogy is an art gallery or museum: it is not "purposeless", but an art gallery doesn't have a goal like "Help someone create a medium-rare steak" or "Tell someone what that error code means". It's open-ended, the visitor/user is meant to derive some degree of personal/self-directed value from the experience. + ### The Toolbox -A toolbox, believe it or not, contains tools. Tools as I understand them are simply procedures or objects created to make some part of life easier or better. It's important to understand that tools are not just physical objects. Mnemonic devices are tools, social etiquette is a tool, color-coding your socks by the day of the week is a tool. +A toolbox, believe it or not, contains tools, and tools as I understand them are procedures or objects created to make some part of life easier or better. It's important to understand that tools are not just physical objects. Mnemonic devices are tools, social etiquette is a tool, color-coding your socks by the day of the week is a tool. + +Tools are all around you, some of them are even part of your body or feel like it, as is the case with things like glasses, mobility aides, or even our mobile phones and I think this degree of immersion is partly responsible for how hard it can be to get a grip on organization. For the most part, people don't *need* to regularly invent tools just to survive. Whether it's mental models or physical objects, there's usually an off-the-shelf tool that comes close to what you need. + +## +It'd be the height of hubris to claim that this is a universal or otherwise comprehensive model for knowledge and note taking. + +### What do I need? +That is the *big* question. What do you need from this note? Is there some specific part of your life that you want to make easier or better by taking this note? Or is it something to be "admired" or "enjoyed" a little more passively, not part of any particular process? + + + + From 11f166901e2d884db04266ac2d223da57aabf1c9 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:29:01 -0400 Subject: [PATCH 3/7] fix header hierarchy --- content/posts/the-gallery-and-the-toolbox/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md index c3819ca..4cb06bb 100644 --- a/content/posts/the-gallery-and-the-toolbox/index.md +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -50,10 +50,10 @@ A toolbox, believe it or not, contains tools, and tools as I understand them are Tools are all around you, some of them are even part of your body or feel like it, as is the case with things like glasses, mobility aides, or even our mobile phones and I think this degree of immersion is partly responsible for how hard it can be to get a grip on organization. For the most part, people don't *need* to regularly invent tools just to survive. Whether it's mental models or physical objects, there's usually an off-the-shelf tool that comes close to what you need. -## +### It'd be the height of hubris to claim that this is a universal or otherwise comprehensive model for knowledge and note taking. -### What do I need? +## What do I need? That is the *big* question. What do you need from this note? Is there some specific part of your life that you want to make easier or better by taking this note? Or is it something to be "admired" or "enjoyed" a little more passively, not part of any particular process? From 7ecacdbd350ce823ae2eeb3035c927f7312215d3 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 08:06:12 -0400 Subject: [PATCH 4/7] last minute drafting --- .../the-gallery-and-the-toolbox/index.md | 28 ++++++++++++++++--- 1 file changed, 24 insertions(+), 4 deletions(-) diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md index 4cb06bb..38099f1 100644 --- a/content/posts/the-gallery-and-the-toolbox/index.md +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -45,17 +45,37 @@ I believe that, broadly speaking, visualizations will fall into one of two class ### The Gallery A gallery is a space where you don't have a concrete "deliverable" goal, but you want to collect things that have meaning. This could be a collection of porcelain miniatures, your favorite inspirational quotes, or a bunch of pictures of possums. The primary analogy is an art gallery or museum: it is not "purposeless", but an art gallery doesn't have a goal like "Help someone create a medium-rare steak" or "Tell someone what that error code means". It's open-ended, the visitor/user is meant to derive some degree of personal/self-directed value from the experience. +#### Examples +I would consider personal journaling a gallery in this framework. You collect your thoughts so that you can later look back over them and have some to-be-determined insight. I've had great success with journaling and it really made me appreciate the process of collecting meaningful things over time. + +Here's a brief list of some other examples. I don't do a lot of gallery-making personally, but I'm trying to cover as much as I can: +- cat photos +- playlists +- collections of quotes ### The Toolbox A toolbox, believe it or not, contains tools, and tools as I understand them are procedures or objects created to make some part of life easier or better. It's important to understand that tools are not just physical objects. Mnemonic devices are tools, social etiquette is a tool, color-coding your socks by the day of the week is a tool. Tools are all around you, some of them are even part of your body or feel like it, as is the case with things like glasses, mobility aides, or even our mobile phones and I think this degree of immersion is partly responsible for how hard it can be to get a grip on organization. For the most part, people don't *need* to regularly invent tools just to survive. Whether it's mental models or physical objects, there's usually an off-the-shelf tool that comes close to what you need. -### -It'd be the height of hubris to claim that this is a universal or otherwise comprehensive model for knowledge and note taking. +#### Examples +My go-to example for tools is recipes. It sounds simple on the surface but consider: +- Is someone diabetic? +- Do you need to track allergens? +- Do you need to track calories or nutritional intake? +- Vegetarian? Vegan? Halal? Kosher? -## What do I need? -That is the *big* question. What do you need from this note? Is there some specific part of your life that you want to make easier or better by taking this note? Or is it something to be "admired" or "enjoyed" a little more passively, not part of any particular process? +Once you start trying to articulate the specific problem you're trying to solve, things get a lot clearer. If I've got to track allergens, I need to make sure that it's hard or impossible for me to misread a recipe and it should probably be named "GLUTEN - Baked Rolls" or something for maximum clarity. + +Lecture notes are another good practical case study and a good example of how galleries and toolboxes overlap. Lecture notes are more open-ended but you usually have a syllabus and some expectations of what your exam will look like, when it will happen and where. If your exam is broken down by chapters in a textbook, your notes will probably benefit from being structured similarly. If the exam covers subjects in chronological order, that may be the best way to organize the information you're saving. +## The look-touch spectrum +To put a finer point on it: all of the concepts and objects described up to now are useful in some capacity. Hammers and saws are good for building houses, creating art makes people feel good ( ideally ) and inspires people to make more art and to think about the world in new ways. What I see as the salient distinction is whether you look at it or touch it. +A hammer can be beautiful, but in order for it to serve its purpose you have to hold it in your hands and bring it into new situations. +Art, on the other hand, is more curated. The creator can't really control precisely which room you're standing in when you hear their song, but they can meticulously craft every second. + +## What do I need? +That is the *big* question. What do you need from this note? Is there some specific part of your life that you want to make easier or better by taking this note? Is it something to be "admired" or "enjoyed" in a hands-off manner? +There's no wrong answer, but I do believe it's important you have *some kind of answer*. Once you can clearly articulate what a note is meant for figuring out what to name it, where to store it, how to connect to other information, all shakes itself out. \ No newline at end of file From 0672fae638d97aed95e88fb25f0e569fe5b06cb3 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 26 Aug 2024 21:10:14 -0400 Subject: [PATCH 5/7] Fixing some grammar and style problems --- content/posts/digging-through-docker-volumes/index.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/content/posts/digging-through-docker-volumes/index.md b/content/posts/digging-through-docker-volumes/index.md index 9dc3f0f..be64f67 100644 --- a/content/posts/digging-through-docker-volumes/index.md +++ b/content/posts/digging-through-docker-volumes/index.md @@ -14,11 +14,11 @@ showFullContent: false This article is only relevant if you know about and use Docker volumes and have some fluency in bash. I'll explain the code as I go, if it helps. ## The Problem -Over the lifetime of a Docker host machine, it's like that orphaned volumes ( and other detritus ) will accumulate over time. You might also find yourself fumbling a configuration and orphaning a volume yourself. +Over the lifetime of a Docker host machine, it's likely that orphaned volumes and other detritus will accumulate over time. You might find yourself fumbling a configuration and orphaning a volume yourself. However we got here, we have a bunch of volumes and we need to know if any of them are important. In a perfect world, they'll have decent names. -However we got here, we have a bunch of volumes and we need to know if any of them are important. In a perfect world, they'll have decent names. We don't live in a perfect world. +We don't live in a perfect world. ## Make a list -Luckily, we have tools at our disposal to handle this. My thought process almost always starts with "Can I turn a list of the things I care about into a newline separated list?" If I can do that, I can start automating my troubleshooting. +Luckily, we have tools at our disposal to handle this. My thought process almost always starts with "Can I make a newline separated list of the things I care about?" If I can do that, I can start automating my troubleshooting. Let's start with `docker volume ls`. This is how we list volumes, but the default output isn't quite what I'm looking for: ``` @@ -29,7 +29,7 @@ local grafana-storage local plausible_db-data local plausible_event-data ``` -This is human readable, and we could even do some slicing with `cut` or `awk`, but Docker gives us a flag that will take us exactly where we need to go: `--format`. Generally, Docker uses Go's `text/template` library to back this feature, and more specifically, individual flags (usually) [document](https://docs.docker.com/reference/cli/docker/volume/ls/#format) the template verbs available. Here, we want `Name`. +This is human readable, and we could even do some slicing with `cut` or `awk`, but Docker gives us a flag that will take us exactly where we need to go: `--format`. Docker uses Go's `text/template` library to power this feature and individual flags (usually) [document](https://docs.docker.com/reference/cli/docker/volume/ls/#format) the template verbs available. Here, we want `Name`. ``` docker volume ls --format "{{.Name}}" d35fce052fbce42b94b2f9b2957be0f77090fa006b1a192030eff07db3675af2 @@ -38,7 +38,7 @@ plausible_db-data plausible_event-data ``` -And now we have a newline separated list of volume names. +We now have a newline separated list of volume names. ## Process of elimination The next part is fairly straightforward. We loop over this list and ask Docker to create a temporary container based on alpine, with a single volume mounted at `/test/`. ``` From 2fe946a604f5af3aee03e29550e0e8708b7d59d1 Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Mon, 8 Jul 2024 07:36:01 -0400 Subject: [PATCH 6/7] Disable this here too --- build.sh | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/build.sh b/build.sh index 1b88f73..5e8374c 100755 --- a/build.sh +++ b/build.sh @@ -1,6 +1,6 @@ #! /bin/bash -HUGOCMD="hugo --enableGitInfo" +HUGOCMD="hugo" # debug alias #HUGOCMD="hugo --enableGitInfo -v --debug --logLevel=debug --printI18nWarnings --printPathWarnings --printUnusedTemplates --templateMetrics --templateMetricsHints" From 0a437ac47eb183ca73d6b5559ac5617324ed1993 Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Wed, 4 Sep 2024 00:51:54 -0400 Subject: [PATCH 7/7] Linking to youtube channel --- content/services/office-hours/_index.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/content/services/office-hours/_index.md b/content/services/office-hours/_index.md index d2da61e..17df5c6 100644 --- a/content/services/office-hours/_index.md +++ b/content/services/office-hours/_index.md @@ -6,6 +6,4 @@ - one or two hours, not sure ## Archives -- write a template/partial that embeds the latest archived session from Youtube - - this would require API calls. can I do it server-side? - - Or I can just manually update the embed once a month +You can find an archive of all my live sessions on my [YouTube channel](https://www.youtube.com/@NickDumas-n6k).