From 752005a0ea9a93dcd88cfad317f13dae14182efb Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Mon, 24 Jun 2024 16:37:03 -0400 Subject: [PATCH 01/13] Typo in hugo flag --- .drone.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.drone.yml b/.drone.yml index d1e3b19..4c6c0a5 100644 --- a/.drone.yml +++ b/.drone.yml @@ -9,7 +9,7 @@ steps: - name: hugo image: code.ndumas.com/ndumas/hugo commands: - - hugo -d /drone/src/public/ --baseUrl https://blog.ndumas.com + - hugo -d /drone/src/public/ --baseURL https://blog.ndumas.com - name: publish depends_on: - hugo @@ -38,7 +38,7 @@ steps: - name: hugo image: code.ndumas.com/ndumas/hugo commands: - - hugo -d /drone/src/public/ --baseUrl https://dev.blog.ndumas.com + - hugo -d /drone/src/public/ --baseURL https://dev.blog.ndumas.com - name: publish depends_on: - hugo @@ -67,7 +67,7 @@ steps: - name: hugo image: code.ndumas.com/ndumas/hugo commands: - - hugo -DF -d /drone/src/public/ --baseUrl https://drafts.blog.ndumas.com + - hugo -DF -d /drone/src/public/ --baseURL https://drafts.blog.ndumas.com - name: publish depends_on: - hugo From c527cf6e48a7b45387018f1943f863c3917678f0 Mon Sep 17 00:00:00 2001 From: unknown Date: Fri, 5 Jul 2024 11:24:29 -0400 Subject: [PATCH 02/13] Finishing 2MG post --- content/posts/too-many-games-2024/index.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/content/posts/too-many-games-2024/index.md b/content/posts/too-many-games-2024/index.md index 1609763..5fb979d 100644 --- a/content/posts/too-many-games-2024/index.md +++ b/content/posts/too-many-games-2024/index.md @@ -1,5 +1,5 @@ --- -draft: true +draft: false title: "Too Many Games 2024 Retrospective" aliases: ["Too Many Games 2024 Retrospective"] date: "2024-06-25" @@ -12,12 +12,12 @@ summary: "In which I drive to Philadelphia and try to play a bunch of games." ### Thursday #### Driving there -My packing checklist made sure I didn't miss anything I needed, so as soon as I got on the road it was a genuinely enjoyable trip. I had a bunch of artificially flavored sports drinks, beef jerky, raisins, I was good to go. +My packing checklist made sure I didn't miss anything I needed so as soon as I got on the road it was an exceptionally enjoyable trip. I had a bunch of artificially flavored sports drinks, beef jerky, raisins, I was good to go. -The drive in was really exceptional. It took about six and a half hours, but in light of the *multiple* 10-14 hour white-knuckle hauls I've had to undertake, it was a dream. The weather was warm but not sweltering, and frequent cloud cover and light rain kept the temperature mostly within reason. The real highlight of the drive was a really tiny boat on a trailer named "Toot Toot". Good luck out there, Toot Toot. +It took about six and a half hours but in light of the *multiple* 10-14 hour white-knuckle hauls I've had to undertake it was a dream. The weather was warm but not sweltering and frequent cloud cover and light rain kept the temperature mostly within reason. The real highlight of the drive was a really tiny boat on a trailer named "Toot Toot". Good luck out there, Toot Toot. #### The Lodgings -I thought my friends booked an AirBnB, but they just booked a regular BnB, some secluded farmhouse well into the rural outskirts of Philadelphia. The farmhouse has wireless, hot water, a fridge, and air conditioning so I can't complain. We picked up our badges and got some food, nothing interesting to note. +I thought my friends booked an AirBnB but they just booked a regular BnB, some secluded farmhouse well into the rural outskirts of Philadelphia. The farmhouse has wireless, hot water, a fridge, and air conditioning so I can't complain. We picked up our badges and got some food, nothing interesting to note. {{< gallery >}} @@ -30,7 +30,7 @@ I thought my friends booked an AirBnB, but they just booked a regular BnB, some {{}} -Later in the evening I saw a deer, I think a white tail doe, just around dusk that first day which was a real treat. +just around dusk I saw a deer, I think a white tail doe, which was a real treat. {{< figure src="day1_white_tail_doe.jpg" @@ -39,12 +39,13 @@ Later in the evening I saw a deer, I think a white tail doe, just around dusk th >}} ### Friday -The tabletop offerings didn't really line up with my schedule, I wanted to spend the evening mostly with my friends while we had the time and all the games stretched well past 6PM. We rocked around the merch hall, I grabbed a few gifts, and we killed a little time before the one Friday panel that caught my eye. +The tabletop offerings didn't really line up with my schedule, I wanted to spend the evening mostly with my friends while we had the time and all the interesting games stretched well past 6PM. I signed up for one game which was pitched to me as "everybody dies at the end": Ten Candles. + +After that, we rocked around the merch hall, I grabbed a few gifts, and we killed a little time before the one Friday panel that caught my eye. #### Character Study, Writing, and Creation This panel was hosted by panelists who introduced themselves as Rachel and Guinevere. I wasn't fast enough to catch all of their social media details but you can find Guinevere [here](https://www.instagram.com/nightsongcosplay/). - -The panel was really solid. Rachel and Guinevere were enthusiastic and knowledgeable and made a point of treating writing and narrative-building as an exercise in fun that anyone can engage in, which I found refreshing. A full reproduction of their presentation would probably not be in good taste, but here's the short version. +The panel was really solid. Rachel and Guinevere were enthusiastic and knowledgeable and made a point of treating writing and narrative-building as an exercise in fun that anyone can engage in which I found refreshing. The core thesis ended up being very straightforward: learn your character. The most important detail is motivation: what do they what, why, what are they willing to do to get it? Only marginally less important, and now in no particular order: - Who are their allies? What (dis)qualifies someone for this status? @@ -83,8 +84,8 @@ I woke up early and saw a white-tail buck grazing down by the stream on the edge caption="This one didn't get scared at any point, he just grazed himself into the forest and out of sight." >}} -#### The Audobon Museum -I did a bit of shopping for museums and the bummer was that most of the big ones are in the city center proper meaning parking and ticket prices were exorbitant. To my absolute delight, I saw that the Aubudon museum and estate were closer to the lodgings than even the convention center, had free parking, and a $7 dollar admission. Sold. +#### The Audubon Museum +I did a bit of shopping for museums and the bummer was that most of the big ones are in the city center proper meaning parking and ticket prices were exorbitant. To my absolute delight, I saw that the Audubon museum and estate were closer to the lodgings than even the convention center, had free parking, and a $7 dollar admission. Sold. {{
Date: Mon, 8 Jul 2024 06:56:25 -0400 Subject: [PATCH 03/13] Total rewrite --- content/posts/notes-as-tools/index.md | 68 ------------------- .../the-gallery-and-the-toolbox/index.md | 45 ++++++++++++ 2 files changed, 45 insertions(+), 68 deletions(-) delete mode 100644 content/posts/notes-as-tools/index.md create mode 100644 content/posts/the-gallery-and-the-toolbox/index.md diff --git a/content/posts/notes-as-tools/index.md b/content/posts/notes-as-tools/index.md deleted file mode 100644 index e595ee8..0000000 --- a/content/posts/notes-as-tools/index.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -draft: true -title: "Notes as tools: A mental model" -aliases: ["Notes as tools: A mental model"] -series: [] -date: "2024-04-24" -author: "Nick Dumas" -cover: "" -keywords: ["", ""] -summary: "Note-taking can present an overwhelming abundance of possibility. Explicitly modelling your notes as tools can grant clarity when creating and organizing your knowledge." -showFullContent: false -tags: -- obsidian -- note-taking ---- -## Outline -- What I assume you know -- Why take notes -- Tools and you -- Tools with purpose -- Tools without -- Conclusion - -## What I assume you know -Nothing in particular, this article isn't even specifically about Obsidian. -## Why take notes? -It's a question worth really thinking about. *Why* are you taking notes? Do you enjoy writing? Does it help you remember? Is it part of a grade? Your answer might be one or more or none of these. Regardless of the answer, what I'm here to argue is that your notes should not be an end in and of themselves. - -## Tools and you -My central thesis is that **notes are tools**. Tools are objects or processes that people create or alter in order to make some part of their life easier or better. Some very obvious examples of tools are things like knives, guns, and cars. Tools can be more complex, though. Factories are tools, eyeglasses and smartphones are tools. - -Tools are not constrained to physical space either. Mnemonic devices we use to memorize how to tie our shoes or our bank passwords are tools as well, existing completely in mental space and active cognitive processes. Beyond the scope of this post but worth mentioning, social constructs are also tools; etiquette, language, art and games are all tools built out of agreements between human beings. - - -Tools are all around you. It is worth putting some thought into precisely what those tools are useful for, to what degree they benefit you and at what cost. Knives are used for separating objects into smaller objects, which is great, but under the wrong circumstances that object might not be something you want made into smaller pieces so that's something you have to take into account while using, organizing, and storing your knife. - -Not all tools are anywhere near as dangerous as knives, but I want to center the idea that understanding the knife's purpose, cutting, informs how you should store it: blade enclosed, handle accessible. - -## Tools with purpose -So, your notes are tools. Now what? - -Unfortunately, this hasn't armed us with a magic bullet. Physical analogies start to fall apart here; in physical space, hammering a nail has consistent characteristics. A pound of steel weighs the same in China as it does in Haiti, the coefficient of friction for pine planks doesn't change based on who's holding the hammer. Notes, or at least the ways we can transform, share, and apply them are not subject to the kind of restrictions that cars or screwdrivers might be. - -In practice, what I try to focus on is **names**. - -> A note with a clear purpose will be easy to name. - -Think carefully about how you're planning on using this note. Where will you be sitting or standing? What time of day will it be? What are the first words that come to mind when you think about the problem this note solves? - -Do you have at least one clear answer for these questions? If not, your note might be doing too much. -## Tools without -Most homes have a place where tools without a clear purpose live. It's usually a drawer in your kitchen -## Conclusion - -## What is a tool? -You are, of course, familiar with tools like hammers and knives. You might have even heard of things like wheels, cars, and guns. These are all fairly self-evident examples of tools: **things that humans create or alter to make some part of their life easier or better**. - -It's important to understand, however, that the category of "tools" is not restricted to things you can hold in your hand. A low-hanging example of this is math, a *mental* tool humans use to process and understand how quantities of things change in response to different stimuli. - -## Tools and You -You work in concert with an endless ocean of tools every day and probably don't think about most of them. This is not a personal failure; a well-designed tool simply requires little to no effort to use. Eyeglasses, cars, phones, books, forks and spoons all augment our natural abilities and let us interact with our environment in ways the benefit us, and most of them are largely invisible in our day to day life. - -This deep integration can leave people at a bit of a loss when starting from scratch in a context where tools aren't readily available or familiar. This is often the case when delving into a new skill, hobby, or profession. - -## Naming Things -One of the most common problems you're likely to encounter while working on your notes is naming them. It is also, I'd argue, the hardest. The most interesting part about names, though, is that they can be an extremely potent "canary in the coal mine" when note-taking. A note that is hard to name is a note whose purpose you do not fully understand. - - diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md new file mode 100644 index 0000000..44428ca --- /dev/null +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -0,0 +1,45 @@ +--- +draft: true +title: "The Gallery and the Toolbox" +aliases: ["The Gallery and the Toolbox"] +series: [] +date: "2024-04-24" +author: "Nick Dumas" +cover: "" +keywords: ["", ""] +summary: "Note-taking can present an overwhelming abundance of possibility. Developing explicit mental models of your notes can grant clarity when organizing your knowledge." +showFullContent: false +tags: +- obsidian +- note-taking +--- +## Outline +- Visualize a note + - is it in a frame or a toolbox? +- Gallery vs Toolbox + - no wrong way to take notes + - are you building something to look at, or something to help you do something? +- Gallery + - Examples + - Journals + - Literal galleries: images, quotes, memories +- Toolbox + - Recipes + - Lecture Notes + - Project documentation +- Choosing your model + - Tools can be beautiful and you can find practical value in appreciating/interacting with art or beauty, it's just helpful to have a clear understanding of the core purpose of the thing you're creating. + + +## Visualize a note +Take your favorite note. Maybe it's a recipe or a really astute observation you made about a book you read. Try to place it in physical space, the first thing that pops into your head. What kind of room is it in? How is it stored? Do you or others do anything else in this room? + +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? + +## 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 +### 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. From 8daa01855a325c313003ef23911d2808a56e415c Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Mon, 8 Jul 2024 07:04:46 -0400 Subject: [PATCH 04/13] I guess gitInfo doesn't work as well as I'd hope --- 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 d84497d00408bcb6741eff13a84f7de24c5622e5 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:06:55 -0400 Subject: [PATCH 05/13] 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 b4212fa0e06f99bf3adf952cadeb4b3c3a8455bd Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:24:06 -0400 Subject: [PATCH 06/13] 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 08b77752a867ff3298de8af6e62a0336fc4b2533 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 07:29:01 -0400 Subject: [PATCH 07/13] 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 2095e79558305e4baccd4788e6a6f8cb18782df8 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 8 Jul 2024 08:06:12 -0400 Subject: [PATCH 08/13] 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 24e6d3939f39eba0c969bdfac8577abe6bb1cae3 Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 26 Aug 2024 21:10:14 -0400 Subject: [PATCH 09/13] 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 69c434b142ab0339ac3a810c4e445b652b0204ca Mon Sep 17 00:00:00 2001 From: unknown Date: Mon, 26 Aug 2024 21:11:57 -0400 Subject: [PATCH 10/13] More work on notes as tools --- .../the-gallery-and-the-toolbox/index.md | 34 ++++++------------- 1 file changed, 10 insertions(+), 24 deletions(-) diff --git a/content/posts/the-gallery-and-the-toolbox/index.md b/content/posts/the-gallery-and-the-toolbox/index.md index 38099f1..d420ebd 100644 --- a/content/posts/the-gallery-and-the-toolbox/index.md +++ b/content/posts/the-gallery-and-the-toolbox/index.md @@ -13,24 +13,6 @@ tags: - obsidian - note-taking --- -## Outline -- Visualize a note - - is it in a frame or a toolbox? -- Gallery vs Toolbox - - no wrong way to take notes - - are you building something to look at, or something to help you do something? -- Gallery - - Examples - - Journals - - Literal galleries: images, quotes, memories -- Toolbox - - Recipes - - Lecture Notes - - Project documentation -- Choosing your model - - Tools can be beautiful and you can find practical value in appreciating/interacting with art or beauty, it's just helpful to have a clear understanding of the core purpose of the thing you're creating. - - ## Visualize a note Take your favorite note. Maybe it's a recipe or a really astute observation you made about a book you read. Try to place it in physical space, the first thing that pops into your head. What kind of room is it in? How is it stored? Do you or others do anything else in this room? @@ -58,24 +40,28 @@ 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. #### Examples -My go-to example for tools is recipes. It sounds simple on the surface but consider: +My go-to example for tools is recipes. A recipe might can call for a lot of nuance depending on your exact use case: - Is someone diabetic? - Do you need to track allergens? - Do you need to track calories or nutritional intake? - Vegetarian? Vegan? Halal? Kosher? -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. +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" 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. +## The look-use spectrum +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. +Art is more curated. The creator can't really control precisely which room you're standing in when you hear their song, but they get to choose what you hear. + +I don't generally believe in strict binaries, and this is no exception. Your tools are art, and your art serves a purpose, but it's helpful to set *some* kind of goal for what you're putting your energy into. Don't feel like you're boxed in, just never be afraid to ask yourself "What is the actual concrete benefit of doing this?" + +Sometimes the answer will be "it makes me feel good or inspired to have some of these around" and sometimes the answer will be more concrete like "I need to make gluten free brownies", "I want to buy this person a nice gift", or "I want to find all mentions of Jeremy so I can follow up during our one-on-one". ## 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 +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 things like where to store it, how to connect to other information all shake themselves out. \ No newline at end of file From e2c6db77a03bbcacb78ce8a91acf49ab5652e2e8 Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Mon, 26 Aug 2024 21:28:17 -0400 Subject: [PATCH 11/13] Adding Ko-fi link --- config/_default/languages.en.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/_default/languages.en.toml b/config/_default/languages.en.toml index aa77bb9..5dc299e 100644 --- a/config/_default/languages.en.toml +++ b/config/_default/languages.en.toml @@ -65,6 +65,6 @@ title = "Form and Function" # { x-twitter = "https://twitter.com/username" }, # { whatsapp = "https://wa.me/phone-number" }, # { youtube = "https://youtube.com/username" }, -# { ko-fi = "https://ko-fi.com/username" }, + { ko-fi = "https://ko-fi.com/nickdumas" }, # { codeberg = "https://codeberg.org/username"}, ] From 5f2aeeee55fbeade8976e3b96d939274642f441e Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Wed, 4 Sep 2024 00:26:39 -0400 Subject: [PATCH 12/13] Folding consult site into primary site --- config/_default/menus.en.toml | 39 ++++++++++++++++++ content/mentoring.md | 40 +++++++++++++++++++ content/services/office-hours/_index.md | 11 +++++ content/services/personal-mentoring/_index.md | 6 +++ 4 files changed, 96 insertions(+) create mode 100644 content/mentoring.md create mode 100644 content/services/office-hours/_index.md create mode 100644 content/services/personal-mentoring/_index.md diff --git a/config/_default/menus.en.toml b/config/_default/menus.en.toml index c105160..a233a1a 100644 --- a/config/_default/menus.en.toml +++ b/config/_default/menus.en.toml @@ -32,6 +32,45 @@ pageRef = "projects" weight = 20 +[[main]] + name = "Contact" + pre = "phone" + weight = 20 + +[[main]] + parent = "Contact" + pre = "email" + name = "Email" + url = "mailto:something@something.com" + weight = 10 + +[[main]] + parent = "Contact" + pre = "mastodon" + name = "Mastodon" + url = "https://fosstodon.org/@nickdumas" + weight = 10 + +[[main]] + name = "Services" + weight = 10 + +[[main]] + parent = "Services" + name = "Office Hours" + pageRef = "services/office-hours" + +[[main]] + parent = "Office Hours" + pre = "eye" + name = "Office Hours Archive" + url = "https://youtube.com/username_tbd/whatever" + weight = 50 + +[[main]] + parent = "Services" + name = "Personal Mentoring" + pageRef = "services/personal-mentoring" #[[main]] # name = "example sub-menu 2" # parent = "Parent" diff --git a/content/mentoring.md b/content/mentoring.md new file mode 100644 index 0000000..9b2bab5 --- /dev/null +++ b/content/mentoring.md @@ -0,0 +1,40 @@ +--- +--- + +{{< lead >}} Life is complicated. Your notes don't have to be.{{< /lead >}} + +## Why should you trust me? +- I've got ~20 years experience in software development, system administration and web development. +- software development is the practice of combining "data" and human input to produce a desirable change in reality +- unique (maybe distinct?) perspective on how to use information to manipulate the world around us + +I've got ~20 years experience in software engineering and system administration, roles which call for attention to detail, the ability to recall and synthesize information in novel ways, as well as identifying problems and breaking them down into specific actionable goals. Effective note-taking is much the same: [notes are tools](https://blog.ndumas.com/2024/09/notes-as-tools) that you create to make some part of your life better. Sometimes the problems they solve are foreseen and sometimes they surprise you. + +Effective software and effective note-taking systems both combine interactive human input with "stored" data to offer a solution to some problem in a person or organization's life. + +## How can I help you? +- Overcome analysis paralysis +- prioritize goals +- create a *flexible* system that can respond to changes in your life + + +### Analysis Paralysis +Knowledge management presents an almost endless ocean of possible solutions. Being able to [rubber-duck](https://en.wikipedia.org/wiki/Rubber_duck_debugging) your problems with someone who can offer concrete guidance on tools that can solve them will let you move from "I don't know where to start" to "It works, how can I improve it even more?" + +### Prioritize Goals +Together, we'll work to identify what you care about and and pick a solution that achieves a reasonable balance between efficacy and the cost of implementation/maintenance; if you spend more time per week "cleaning up your notes" than using them, your notes are not benefitting you. + +### Create a flexible system +I'll work with you to create a system that allows for *iterative* evolution by minimizing the complexity and labor required to keep your notes useful. Life changes and we are ill-served by refusing to change with it. The notes you need today may not be useful tomorrow and vice-versa. My methodology emphasizes setting concrete goals for each note. This allows you to confidently measure when a note is "done" or at least "good enough for now". + +## Services +### Office Hours +- Once a month, I host an hour long Q&A session. Questions/requests will be addressed on a first-come first-serve basis. + - I will only be able to spend 5-10 minutes maximum on any given question + - these sessions are an opportunity for guests to interact with me directly and feel out whether my methodologies are a good fit for them +- link to zoom or Google Hangouts or whatever +- link to Youtube archive of previous Q&A sessions + +### Personal Mentoring +- for some amount of currency, you can book a one or two hour session +- we'll review your goals, your needs, and any other relevant factors diff --git a/content/services/office-hours/_index.md b/content/services/office-hours/_index.md new file mode 100644 index 0000000..d2da61e --- /dev/null +++ b/content/services/office-hours/_index.md @@ -0,0 +1,11 @@ +--- +--- + +## Schedule +- first something of the month +- 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 diff --git a/content/services/personal-mentoring/_index.md b/content/services/personal-mentoring/_index.md new file mode 100644 index 0000000..e1d5d9a --- /dev/null +++ b/content/services/personal-mentoring/_index.md @@ -0,0 +1,6 @@ +--- +--- + +## Pricing +- One hour: 75$ USD +- Two hour: 150$ USD From df34b4f69c6a3b6301e7bd4f6236325dfe1a9e4b Mon Sep 17 00:00:00 2001 From: Nick Dumas Date: Wed, 4 Sep 2024 00:34:49 -0400 Subject: [PATCH 13/13] Moving everything onto the primary domain --- .drone.yml | 12 ++++++------ config/_default/hugo.toml | 2 +- config/_default/params.toml | 6 +++--- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/.drone.yml b/.drone.yml index 171adbe..3110dcf 100644 --- a/.drone.yml +++ b/.drone.yml @@ -20,9 +20,9 @@ steps: user: blog delete: true recursive: true - hosts: ["blog.ndumas.com"] + hosts: ["ndumas.com"] source: /drone/src/public/ - target: /var/www/blog.ndumas.com/ + target: /var/www/ndumas.com/ include: ["*"] when: branch: @@ -38,9 +38,9 @@ steps: user: blog delete: true recursive: true - hosts: ["blog.ndumas.com"] + hosts: ["ndumas.com"] source: /drone/src/public/ - target: /var/www/dev.blog.ndumas.com/ + target: /var/www/dev.ndumas.com/ include: ["*"] when: branch: @@ -56,9 +56,9 @@ steps: user: blog delete: true recursive: true - hosts: ["blog.ndumas.com"] + hosts: ["ndumas.com"] source: /drone/src/public/ - target: /var/www/drafts.blog.ndumas.com/ + target: /var/www/drafts.ndumas.com/ include: ["*"] when: branch: diff --git a/config/_default/hugo.toml b/config/_default/hugo.toml index adb3f3a..b8bf101 100644 --- a/config/_default/hugo.toml +++ b/config/_default/hugo.toml @@ -3,7 +3,7 @@ # https://blowfish.page/docs/getting-started/ # theme = "blowfish" # UNCOMMENT THIS LINE -baseURL = "https://blog.ndumas.com/" +baseURL = "https://ndumas.com/" defaultContentLanguage = "en" # pluralizeListTitles = "true" # hugo function useful for non-english languages, find out more in https://gohugo.io/getting-started/configuration/#pluralizelisttitles diff --git a/config/_default/params.toml b/config/_default/params.toml index d4cf2db..68664cf 100644 --- a/config/_default/params.toml +++ b/config/_default/params.toml @@ -149,6 +149,6 @@ smartTOC = true # yandex = "" [AnalyticsURL] - "https://blog.ndumas.com" = "blog.ndumas.com" - "https://drafts.blog.ndumas.com" = "drafts.blog.ndumas.com" - "https://dev.blog.ndumas.com" = "dev.blog.ndumas.com" + "https://ndumas.com" = "blog.ndumas.com" + "https://drafts.ndumas.com" = "drafts.blog.ndumas.com" + "https://dev.ndumas.com" = "dev.blog.ndumas.com"