Collection of "Today I Learned" notes
github.com
github.com
AMA!
Some notes are referenced constantly, and some I've probably never looked at again. The interesting thing is it's hard to predict when adding which one it will be...
Do you find yourself using the date of entries much? It never occurred to me that I should be timestamping my snippets, and I'm curious if I'm missing out. I do tag them with an entry from a very simple taxonomy (shell, aws, macos, git, docker, etc etc)
As I'm using org-mode, I should really just customize org-journal-new-entry to include a timestamp. Or maybe something similar with org-roam. Argh! The temptation of yak-shaving is too great sometimes.
I also host my "Learning in Public" on GitHub, my blog, my notes my journal as README.md files, my code is all on GitHub . I've been doing it since 2013.
I like it being on GitHub because when I'm on a desktop computer, I can clone the git repository and edit locally, when I'm on a nondevelopment machine or Android phone I can edit on the GitHub website through the web editor.
The ability to navigate between notes via the same "go to references" and "go to definition" hotkeys that I use while coding... It's pretty nice.
- GitHub have world class backups - commit something there and it gets replicated to data centers on three continents (I believe) - and a free public repo there won't vanish if you forget to update an expired credit card
- Related: GitHub is free. I care about this not because of not wanting to pay now, but because I don't want my content to be at risk if I forget to pay in the future (or can't pay for whatever reason)
- GitHub has several great web UIs for editing content, in addition to being able to edit in any other tool that supports the git protocol
- GitHub Actions makes it possible to add all sorts of automations on top of your notes, again for free. I use that to deploy my custom https://til.simonwillison.net site (mainly to give myself search)
- GitHub's own search is pretty good though!
- You can also use GitHub Pages if you just want a custom static site version of your notes.
- If someone spots a typo in your notes they can submit a PR to fix it!
https://dev.to/jbranchaud/how-i-built-a-learning-machine-45k...
Linked from the article in the post to his inspiration, let me to learnt today that I can batch-rename files in macOS natively - https://www.techjunkie.com/batch-rename-files-os-x-yosemite/
I love cmd+tab on a mac to switch between applications, but I was missing a feature to switch between windows of the same application. Alt+tab solves that in the same manner Windows does.
I love the idea of using GitHub Issues to create and share notes that I found each every morning, I hope that people find it useful.
However, I've never used GitHub before. Help?
(I don't know how familiar you are with the following topics).
As long as your documentation is just plain text files, it can be versioned easily. In fact, many people have used github to create whole books about many different subjects. It ties nicely into the "issue tracker" functionality, cause you can use it as a starting point for discussions that later turn into new functionality or fixes.
You can also use the builtin wiki functionality, just got to "Wiki" on a new repo and click "new page". This has the added benefit that you don't really need to understand the git tool itself and you can start creating content right away.
Either way, I recomend looking up "markdown syntax", as it is very convenient when you're writing a book and its also used for the wiki functionality.
Hope it helps!
I am a non-technical technical person in that I understand a lot of random technical concepts, but not necessarily how they work in practice.
I'm not too worried about creating content right away. I am more concerned with designing the system correctly and then working on converting my project to that system.
The first phase of the project is identifying, collecting, and documenting kitten issues and solutions. The goal is to create a central repository for academic purposes, because kitten information is fragmented among nonprofits and cat breeders.
The repository is a first step in answering the question "What can I do to help kittens?" for any skill level). It's the technical information that the rest of the project is based on.
I think maintenance is more important for this first phase. Being human- and machine-readable is important. Ease of use is more important in later stages.
This reminds me of one, but with an obvious IT overtone.
I dont want to criticize someone else's personal notes, but I wouldn't call it "SSH into a docker container" other than as a metaphor; but it's too close to the process for the metaphor to stand. SSH has nothing to do with it.