-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
63b1299
commit cbda507
Showing
6 changed files
with
66 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,24 @@ | ||
<!DOCTYPE html> | ||
<html lang="en"> | ||
|
||
<head> | ||
<link rel="shortcut icon" type="image/png" href="../../assets/img/favicon.png" /> | ||
<title>First things first: Make a list</title> | ||
<link rel="stylesheet" type="text/css" href="../../assets/css/main.css" /> | ||
<script type="module" src="../../assets/scripts/md-block.js"></script> | ||
</head> | ||
|
||
<body> | ||
<div class="main-container"> | ||
<nav class="blog-navbar" role="navigation"> | ||
@hannahilea: | ||
<a href="../.." class="nav-link">home</a> | | ||
<a href="../../projects" class="nav-link">projects</a> | | ||
<a href=".." class="nav-link">blog</a> | | ||
<a href="mailto:[email protected]" class="nav-link">contact</a> | ||
</nav> | ||
<md-block src="./src.md"></md-block> | ||
</div> | ||
</body> | ||
|
||
</html> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,31 @@ | ||
# First things first: Make a list | ||
|
||
To-do list: | ||
- [x] Make a list | ||
- [x] Intro/define | ||
- [x] Cite Chuck | ||
- [x] Pen and paper usage | ||
- [x] PR punch lists | ||
- [x] Publish post | ||
- [ ] Remove this to-do list from top of post | ||
|
||
--- | ||
I am a big fan of Making A List, whether on paper or digitally.[^skill] | ||
|
||
As taught to me by <a class="impersonal" href="https://futurestatesband.ca/)">Chuck</a>[^chuck], **the most important thing about a to-do list is that the first item on it is "Make a list"**. Then, when you've finished adding tasks to your list, you can check it off immediately. Bam, [dopamine](../driven-developments/). Happy day, you're already partly done with your list! Look at you, so much progress already! | ||
My notebook is filled with (partially-completed 😅) daily to-do lists, each of which starts with "make a list". | ||
|
||
The one type of list I don't regularly start this way is the <a class="impersonal" href="https://en.wikipedia.org/wiki/Punch_list">punch lists</a> that I often add to pull requests (PRs). (Pull requests are proposals to merge a set of changes into a set of existing documents, e.g., source code.) PR punch lists both keep me on task and let my reviewers know what subtasks I intentionally considered---and, implicitly, what I did not. (Are you requesting a non-trivial review from me? Bonus points if you include a punch list!) | ||
|
||
I've also found that adding a punch list to a <a class="impersonal" href="https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/creating-a-pull-request-template-for-your-repository">Github PR template</a> helps improve review turnaround time and reduces review friction, and sets newer contributors up to succeed more quickly. | ||
|
||
[^skill]: This is a different skill than the skill of completing tasks, mind... | ||
|
||
[^chuck]: One of the most valuable things I learned in grad school! | ||
|
||
<footnotes/> | ||
|
||
--- | ||
- created: 2024-09-21 | ||
- last updated: 2024-09-21 | ||
- tags: musings, devtips, DDD |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters