9 ms·

Keep a Log

226 points by brunooliv 5y ago

orliesaurus 5y ago
No one mentions indexing the content as a really important part of logging your notes?
mianos 5y ago
I use simplenote for this. Mandatory for me is: - synchronisation across multiple machines - synchronisation on android - markdown - reasonable search - sorting by date Over the last few years I have tried many applications for this and many have failed. I really liked boost, but the whole paid/free/app/webapp mess with whole backups disappearing freaked me out.
ms123 5y ago
if anyone's interested in keeping a public log, i maintain smol.pub.
c_o_n_v_e_x 5y ago
I’m a product manager and keeping a decision log is a must for me. “Big” decisions / major changes getting logged along with the context of how and why the choice was made. Sometimes decisions get revisited and it’s nice to have all of your context, particularly if you are having to defend a choice that was made.
zuj 5y ago
I think any sort of memory dump, be it personal or professional is helpful. I used to write the morning pages and got out of habit and trying to get back. More than "cognitive offloading" as others mentioned it helped me in processing the past day. Never tried logging the work related stuff. Will give it a shot.
dSebastien 5y ago
I agree with this. I tend to remember a lot more when I take time to write things down. It was the way I studied, and is now the main way I learn new things. Writing can take different forms (written words or code), but in both cases, it makes ideas clearer, helps me create mental models, and help me shape my thoughts. I heavily recommend journaling and PKM in general. I recently wrote a few articles on the subject: https://dsebastien.net/blog/2021-10-07-periodic-journaling-part-1 https://dsebastien.net/blog/2021-10-07-periodic-journaling-p... https://dsebastien.net/blog/2021-10-07-periodic-journaling-part-2 https://dsebastien.net/blog/2021-10-07-periodic-journaling-p... https://dsebastien.net/blog/2021-12-03-personal-knowledge-management-organization https://dsebastien.net/blog/2021-12-03-personal-knowledge-ma...
fareesh 5y ago
What's a good tool that: 1) Loads in under 5 seconds 2) Is searchable, and can hyperlink to other entries 3) Syncs across devices
- Eugeleo 5y ago
  You can try obsidian.md
concombre 5y ago
I store my TODO list in a markdown file. I edit this with Vim and store this on a git repository. I realized some month ago, that the log is provided for free by git. If I run gitk, I can access all the history of task completion.
- nefitty 5y ago
  Oh wow I had never thought of this. My favorite method was to duplicate a daily task list in Evernote every morning, and resetting all the inputs. I'm going to automate that process now. You might have just solved the storage model part of my design. Thanks for taking the time to share!
Lhiw 5y ago
I keep a daily log of what I work on, i also drop other info links and notes. This is mostly to facilitate daily updates in lieu of stand ups. Another thing I do along side my todo.txt is log important team changes, team switches, people encounters, side projects and any major project milestones that might be useful to point out in my 6 month reviews. It's really amazing to search back and find links to things you did months ago when search won't pick it up.
matrixcubed 5y ago
I can’t recommend Joplin, synchronized with a cloud storage of your choosing, enough. Markdown, mermaid diagrams, tags, encryption. Everything I need to recall, on every computer I use.
Trufa 5y ago
I made a dead simple tool today for this purpose to try out svelte: https://dev-logs.netlify.app/ https://dev-logs.netlify.app/
slk500 5y ago
emacs org mode
syngrog66 5y ago
summary of the OA: note taking is helpful reaction: agreed. best practice and known as such for a long time I write notes in a plain text file for every project I work on. As I start to see things accumulate around a particular tool, technology or service (or any other common or cross-cutting concern), I eventually carve those note portions out of my per-project notes, clean them up and merge them into a notes file dedicated to that thing. I also look for portions of my notes worth extracting and transforming into executable scripts, complete with variables or templates where makes sense. Plain text notes are also easy to search, version and replicate around. Can upgrade some to Markdown or another structured text format where yields net value. Rinse and repeat. These habits yield increasing ROIs over one's life and career.
ahnberg 5y ago
This is such a valuable recommendation. I've been doing the same since 20+ years back. On and off I've been bad at it, but I always end up coming back and continuing. I think of it as more of a daily diary though, I mix random notes of things I've done, thought of doing, or interesting links and/or command-lines I've found useful so I don't have to reinvent them as often in the future. It has proven to be immensely useful for myself. Can highly recommend! My way is mainly org-mode files through Emacs over the years. Now having switched primarily to VScode I use a simplified org-mode version to get similar feeling, and it works pretty well. Everything is mostly text anyways!
whateveracct 5y ago
I have a few GitLab projects I use for this. Some are actual code things, and a couple are just for notes. I make issues all the time along with using the wiki.
michaelmcdonald 5y ago
The author mentions utilizing Slack for this; do so with caution. The free Slack tier only keeps 10,000 messages in history with the added drawback of now your knowledge stash is stored on servers with a 3rd party company rather than files you own / control.
- neilparikh 5y ago
  I think Slack actually keeps all your history, it just hides older messages from you. If you subscribe to the paid tier, you should be able to see the older messages.
- brunooliv 5y ago
  Thanks for the warning :)
adamnemecek 5y ago
It’s not writing that’s hard, it’s finding it later, and more importantly remembering that I wrote something down.
- lijogdfljk 5y ago
  Agreed. I wonder, what might be some mechanisms that would aide in finding things later? I feel like i often forget some keyword to find history items like this, but i _can_ find something near by. So maybe a way to narrow your history scope?
- Taylor_ 5y ago
  I have recently made the switch from using Mac's built in Notes app to using obsidian.md which focuses heavily on linking. It seems to be quite good for searching and recalling information. Although I have been using it for about 3 weeks.
jsguy 5y ago
1989 - 2007: notes.txt, 2007 - the future: notes.md
jcun4128 5y ago
I'm still wondering like where should it be. We all carry a phone with us. Seems like adding an extra thing (like earbud holder) sucks... servers "what if it went down"... At the moment I use different combos. I have made a few things, like a url-rest thing that's encrytped at rest where the entire website page body is a textarea element. Authenticated and unauth (local) versions. Desktop app. Phone note widget. One I'm working on is a chrome extension one since I use Chrome everyday. The main thing is it has to be made by me, ego. I used to use One Note but now I'm scared/cringe to look back at my younger self's thoughts ha.
jsemrau 5y ago
I use Evernote for this.
- deleted 5y ago
  [deleted]
pphysch 5y ago
I use Obsidian[1] pointing at a local directory of markdown files which is also synced across my devices via Syncthing[2]. Works flawlessly across my various Android/Fedora/Windows/etc devices. Cost: $0.0/year. I don't really use any Obsidian plugins. Obsidian has good builtin navigation, search, and markdown processing (e.g. LaTeX, code syntax highlighting). It's just as easy as opening a new file in $EDITOR, except its a markdown renderer & synced across all my devices. There are also a lot of bells and whistles like graph viz, export to website, etc. that haven't gotten in my way. [1] - https://obsidian.md/ https://obsidian.md/ [2] - https://syncthing.net/ https://syncthing.net/
- number6 5y ago
  I use the same setup + logseq. Gamechanger
  - sbmthakur 5y ago
    What's the benefit of using logseq?
    - number6 5y ago
      Logseq has a build in query language. You can query every block of information. It's organised around blocks rather than pages. So you tend to organise your thoughts in packages. And you can reference blocks in your current page so you have a direct link. Though I think Obsidian does this to. The differences are quite subtle but profound.
      - sbmthakur 5y ago
        Understood. Do you use anything to sync data between both tools?
- wodenokoto 5y ago
  > I use Obsidian ... Cost: $0.0/year. For the use-case of a professional developer employed at a company with more than two poeple, it is $50.00 / year [1] [1] https://obsidian.md/eula https://obsidian.md/eula "Get a commercial license for each user" -> https://obsidian.md/pricing https://obsidian.md/pricing
joshlemer 5y ago
The easiest way to incorporate this into a typical developer's workflow is using the vscode-journal plugin: https://marketplace.visualstudio.com/items?itemName=pajoma.vscode-journal https://marketplace.visualstudio.com/items?itemName=pajoma.v... How it works: From any file, in any project, in VsCode just press CMD + SHIFT + J, select 'Today' and it will plop you into the journal page for today with today's date at the top.
- staindk 5y ago
  I've been keeping a 'work diary' in VS Code - tried a couple of simple notes plugins but I ended up just pinning my diary.md file in my main window... always easy to get back to it. I think the only other QoL I have for it is the markdown snippet I created that creates the current day's date and other boilerplate data when you type 'td'. It works really well for me, and I back up to a private git repo.
azaras 5y ago
Emacs org-mode is better than Markdown.
- AceJohnny2 5y ago
  +1 for Emacs Org-Mode. But of course you'd have to have bought into the Emacs ecosystem. Then again, Org-Mode may be a good first step!
  - User23 5y ago
    Evil mode makes org-mode very approachable for anyone familiar with vim. Grab doom emacs or spacemacs if you want it to just work. Also, Elegant[1] is an attractive and simple config. It would probably be worth packaging it or something very similar up with CUA bindings and marketing it as just a standalone notetaking app with Emacs just being an implementation detail. [1] https://github.com/rougier/elegant-emacs https://github.com/rougier/elegant-emacs
abathur 5y ago
I find I always fail out of the append-only approach (even though I realize it means I'm spending more ~orgnizational time/energy). I can't claim to do it "regularly" in the sense that I do it every day, but I guess I do something like it in that almost every one of my projects has one or more PlainTask documents (i.e., documents that use org-mode-alike PlainTasks extension for Sublime Text). These documents usually start one day as a scratch space to remind me what I was doing before I take a break, or to plan out the next few steps. In any non-trivial project, it'll tend to grow to at least a few hundred lines, and almost all of them accrue a top-level section, at the top, titled KNOWLEDGE, where I (my better self, at least) try to record slippery or hard-won technical details I picked up along the way (even if I'm not smart enough to note them the first time or two I have to bang my head against them). I may not consult most of them again, but they can be a huge help when I get a chance to return to something that I had to back-burner 2 or 3 years earlier, and all of the critical detail has been displaced by newer ephemera...
nickjj 5y ago
Since about 2001 I used YYYY-MM.txt plain text files and have a shell script to help create notes in the most friendly way I could think of from the command line at https://github.com/nickjj/notes https://github.com/nickjj/notes. Totally works fine for a knowledge log when you're streaming high level details from your brain into text. I still use it today. The repo hasn't been updated in 2 years because it's a ~20 line script with a simple API that hasn't failed yet. But when you want to really go all-in with in-depth notes on 1 semi-broad subject it's tricky because in 1 month's time if you're hardcore deep in the woods of learning, applying and using something you're going to end up with hundreds of concepts from an assorted set of tools and it kind of stinks to have all of that info sitting in 1 file. Think about using something like Kubernetes. That's really Kubernetes, Kustomize / Helm, EKS, various cloud hosting details (networking, etc.), Terraform and ton of super useful commands / context. Details you for sure want recorded for later. For this type of info I've been building up a personal knowledge base with https://obsidian.md/ https://obsidian.md/. It's really nice and I highly recommend it. It's been working well for keeping things reasonably categorized without wasting a lot of time on the details around keeping links and tags up to date. It also has Vim mode that's good enough where day to day writing feels natural.
- zephyr9 5y ago
  Hate to nitpick but #!/bin/bash is not actually zero-dependency, as bash is not installed on BSD by default, and if installed won't be located at /bin/bash. You could probably just change to #!/bin/sh without issue.
  - nickjj 5y ago
    Thanks for bringing this up. It does mostly work the same with shell but the -p flag of read isn't available with POSIX compliant shell. I ended up changing that slightly and pushed a patch to use sh now. Every other feature of the script worked the same with sh without modification. As for using #!/bin/bash instead of #!/usr/bin/env bash, that was an oversight from 2 years ago. I addressed that too in the above patch by using #!/usr/bin/env sh.
- swansonator 5y ago
darkteflon 5y ago
I failed to do this throughout my first career. It’s one of my biggest professional regrets - perhaps the biggest. Reader, don’t be like me.
mtlynch 5y ago
I wrote a tool specifically for this, mostly inspired by the Snippets tool at Google. I've been publishing my weekly log in it every week for almost three years: https://whatgotdone.com/michael/2021-12-03 https://whatgotdone.com/michael/2021-12-03 The code is all open source if you're interested in playing around with it: https://github.com/mtlynch/whatgotdone https://github.com/mtlynch/whatgotdone
beembeem 5y ago
My append-only system for *nix, sits in my .bashrc: # Open Personal Logfile at end, optionally appending log entry for today if it doesn't exist function ed () { local _cur_date _most_recent_date; _cur_date=$(date +%m/%d/%Y); _most_recent_date=$(grep --color -o -E "^# [0-9]{2}/[0-9]{2}/[0-9]{4}" ~/${LOG_FILE_NAME} | tail -n 1 | cut -d' ' -f2-); if [[ "${_cur_date}" != "${_most_recent_date}" ]]; then echo -e "\n#\n# ${_cur_date}\n#" >> ~/${LOG_FILE_NAME}; echo "Command Comments" >> ~/${LOG_FILE_NAME}; printf "%0.s-" {1..81} >> ~/${LOG_FILE_NAME}; echo >> ~/${LOG_FILE_NAME}; fi; $EDITOR +$(($(wc -l ~/${LOG_FILE_NAME} | awk '{print $1}')+1)) ~/${LOG_FILE_NAME} } >>> # # 12/03/2021 # Command Comments --------------------------------------------------------------------------------- <some cmd> # My description of what cmd does, in my own words
- jldugger 5y ago
  a few months ago, some folks on HN pointed me at https://jrnl.sh/en/stable/ https://jrnl.sh/en/stable/
agambrahma 5y ago
Churned through a lot of ideas/apps for this over time, what works (not 'best' but 'well enough') for me right now is LogSeq. - Daily notes as roots - Local storage - Plain text storage - "wiki-links" - Backlinks and easily traversing notes - Hierarchical format for notes (with folding, so I can "tuck away" a bunch of text and screenshots when I don't want to look at them)
- karencarits 5y ago
  Me too! It's really nice, and integrated version control by git is great
decebalus1 5y ago
Ah.. time for the monthly note taking generic PKM HN post. Has nobody mentioned Zettelkasten yet? I see org-mode already made an appearance... Either way you go, don't forget to self-host!
- asdfgeoff 5y ago
  If it's not plaintext and client-side encrypted, is it even worth writing down?
ortusdux 5y ago
There is a documented phenomenon called the Photo-Taking-Impairment Effect, where taking photos of something can reduce your ability to recall details about it at a later date. It was originally theorized that it was a sort of 'cognitive offloading', but further tests have shown that reviewing and deleting the photos does not make up for the deficit. https://www.sciencedirect.com/science/article/abs/pii/S2211368117301687 https://www.sciencedirect.com/science/article/abs/pii/S22113... I remember finishing a complex math test in high school and checking my calculator's memory to find that I had done some rather simple single digit multiplication that I had no recollection of. Ever since then I've tried to be conscious of what I offload and what the long term consequences might be. For example, I'm confident that my ability to spell has decreased as spellcheck technology had advanced. I'm not recommending against keeping a log. In fact I keep several myself. I use google keep for simple things that I eventually want to forget. I use anki flash cards for spaced repetition study of short concepts that I want to remember. I use oneNote for sprawling interconnected datasets. And lastly, I used waldenpond.press to print and bind stories and articles that I want to remember and revisit. I just think that there is a risk to haphazardly externalizing more and more of your cognition. I started a new carrier 5 years ago, and found that many of my skills had atrophied over the years. I think I spent more time in my first 6 months relearning abilities I had taken for granted 10 years earlier than my new job duties.
- smusamashah 5y ago
  I dont know if this is what you are talking about but I have noticed so many times that when trying to recall an event I took a photo of, first image I get in my head is that photo. I try build the rest around that photo and it only works for very old photos/memories. For recent ones (e.g. photos of my newborn) I only see the photo in my head instead of the actual visual event. This makes me sad when I try to remember seeing him for the first time, I can only remember a few things and lots of photos. Now to mitigate that, I still take photos but avoid reviewing them immediately. I would rather go through them later when trying to recall. When I review immediately, it feels like the photo overrides the visual memory of the real event.
- makeitdouble 5y ago
  This study is interesting, but very narrow and might not be relevant to a lot of practical situations. In particular the reverse effect is observed on other subjects, manual note taking improving memory for instance. I think the important part here is that the “log” isn’t the goal nor something we are explicitely asked to do, but a step that comes after we experienced the work. I would compare it to taking photos of your own painting: arguably you wouldn’t be remembering a piece less because of the photo, you’ve been staring at it for hours/days in the first place.
_ink_ 5y ago
I very often fail in identifying the things that need to be added to the log. List running docker containers? So easy it's not necessary to log. That one obscure bug that took days to fix? So many things were tried that didn't lead to success, that the path to the solution is not clear anymore.
jldugger 5y ago
Five years ago I decided to buy rocketbook, which I use as a sort of journal. Obvious things go in there, like meeting notes & action items, but also notes from watching conference presentations, weekly Todo list tracking (ala bulletjournal), and outlines for phone calls I need to make (I find the preparation helps with the anxiety of making first phone calls, by collecting important data i might need and key points i need to accomplish ahead of time). I think I prefer the analog nature vs digital notes apps, and the scanner app helps with posterity concerns. Most notes are not that important a year from now! I used to take notes while reading books, but I've since moved that to part two of the system. For things where I absolutely want to remember something, it goes into Anki. While reading books, I make time to go over the chapters and extract key ideas into Cloze deletions. Helps with recall, and the Cloze format helps with recall since you're given far more context. And perhaps useful for search. For shell / computer stuff, keeping history around helps a lot. In theory important commands could become aliases or functions and kept around via git, but this is more rare. I do have a gnote / tomboy setup that I use mostly for long form writing, but that's less about journaling experiments & discoveries for later reference and more about getting plans and ideas out of my head so I can stop thinking about them, and drafting the occasional blog post.
brunooliv 5y ago
Glad to see this has ressonated with so many of you!! Thanks for all the amazing insights in the comments where, as always, a lot of the value lies.
pmulard 5y ago
Right now I'm trying to decide exactly how much information I should store in my knowledge base. There's a balance to keeping the base small enough to actually find the information needed and avoid it becoming a huge bloated mess. For example, I keep separate Notion pages for each programming language I use. I also recently started learning Rust and have built up a page that includes even basics like how to declare a variable. The idea was it can exist as a beginner guide and someone can run through it relatively quickly and get a jist for the language. But if I keep using the language, that information may eventually become obsolete (since I'll have it memorized) and will probably be a waste of space. Then as I advance through the language, I'll want to take note of more advanced concepts and maybe even some specific use cases of problems/solutions to code I'll have written. I guess that's the beauty of editing a knowledge base over time. You can edit it to conform what's in currently in your head right now. So maybe in a few years from now, having those simple variable declarations will be a waste of space and I'll just want advanced topics covered. Or maybe I'll walk away for a few years and need to look up basic syntax again.
- teach 5y ago
  In my experience there's not much risk of having a "huge bloated mess" so write more rather than less. I keep all my work-related knowledge in just a single flat text file, which after four years at my current company is just under 20,000 lines long and ~750 KB. It's easy to grep and so I can find virtually anything quickly. I think trying to get too fancy with organization could lead to troubles. A badly-organized knowledge base is hard to fix. Most of the time I'm just kicking myself that I didn't write down something that I was sure was in there.
simonw 5y ago
I've been using GitHub Issues for this for the past few years, and I absolutely love it. Each of my projects has issues. If I'm fixing a bug or working on a feature I open an issue for it, then I post a stream of comments as I figure out the details, make decisions, find examples of code that I need to use and so on. I have my own private notes repository which I just use for this for things that don't relate to a current project and that I don't want to publish yet. I add a "research" label to my repos, and open research issues for ideas or for things that I want to explore that are relevant to the project in some way. Recent example: https://github.com/simonw/sqlite-utils/issues/344 https://github.com/simonw/sqlite-utils/issues/344 - researching STRICT mode that was just added to SQLite, and seeing if it would make sense to support it in my sqlite-utils library. GitHub's issues API is comprehensive, so I have a cron that exports all of my issues and comments into a SQLite database that I can access with Datasette. I have a private one with all of my projects, and I also run a public one at https://github-to-sqlite.dogsheep.net/github/issues https://github-to-sqlite.dogsheep.net/github/issues with just the issues from my public Datasette-related projects. I use search against these often. I occasionally even re-discover old notes from Google searches, which include the ones from my public repositories. Many of my issues have dozens of comment replies, all from me. It's a great way of keeping a log.
_nickwhite 5y ago
I used to keep a huge Notepad .txt file of a ton of company knowledge, gotchas, offhand documentation, and any kind of tidbit that I might need later. A few years ago, I migrated all of this to OneNote with detailed, formatted notebooks for every broad subject I could categorize. I recently shared my OneNote notebook with guys relatively new to my team, and I found them using it all_the_time. So not only is the "Knowledge Log" good for you, it can also be a useful tool to help others on your team.
- alexpetralia 5y ago
  I've been doing the same exact thing for about 5 years now and I can't think of any skill I'd rather have than this one. I wrote more about my system here: https://news.ycombinator.com/item?id=25302365 https://news.ycombinator.com/item?id=25302365
- errcorrectcode 5y ago
  Awful solution. There are wikis. Dokuwiki is a simple one, or Mediawiki.
  - narrator 5y ago
    At my old company, whenever anyone had a question about the system, we'd reply back with a link to a wiki page with the answer. It worked pretty well. We could either create the wiki page, update it, or refer to an existing one.
    - errcorrectcode 5y ago
      This is a good solution. That way, knowledge hoarding is often averted if the creator is willing to add info when it's fresh or lacking a procedure, and finder searches the docs before asking. I really hate the antique-mindset, amateurish shops where they don't use DVCS, wikis, or configuration management. "Oh yea, only Jim knows how that works" is one signal of intense knowledge hoarding.
rafalbel 5y ago
I can relate to that. Without my notes I'd be lost. Always trying to keep them simple and, if required, to make it accessible to others, to avoid creating tribal knowledge.
errcorrectcode 5y ago
Revision-controlled wikis are much more organized than some linear information overload or unsearchable paper bullshit.
dukeofdoom 5y ago
I started doing this for some software projects I wrote. I created a text file, and every time I fixed an issue, I would make a log entry. Notes what the problem was, what I did and how I fixed it. Since a long time can elapse between bug fixes, I tend to forget how things work. This is super nice to refresh my mind and saves lots of time.
defenestration 5y ago
To retain knowledge and my considerations for my future self and teammembers I create a document before each major task and update it during the task. The headings are: Goal (why are we doing this), Crux (what is the most important consideration, what will make the biggest difference), Current situation (where are we now), Steps (what needs to be done or what is done to reach the goal. The steps can contain specific details on how to get the step done) and Learnings (what did we learn, what are key insights). The files are named YYYY MM DD Taskname. Looking at the directory gives a sense of history. It’s a delight to find a document like this when doing the same task a year later. It also helps to delegate tasks to other teammembers.
- decebalus1 5y ago
  This! This is the way! I envy your coworkers. This practice is also one of the things that help me overcome chronic procrastination. For every project/feature/bugfix/etc.. I start with such a document in which I try to pin down exactly that. The goals (and explicitly calling out non-goals to fight off Feature Creep Frank[1] from the get go), the whys and the hows. The hows should be as detailed as possible. The hows/whys may be getting updated (with history, for this, I just strike through and add a date for the change, nothing fancy like revision history in the storage media). And whenever I feel like slacking off, the detailed tasks in these documents offer me a way out of a rut. [1] https://github.com/zsoltika/hacknot/blob/master/hacknot.md#feature-creep-frank https://github.com/zsoltika/hacknot/blob/master/hacknot.md#f...
efazati 5y ago
I started doing this, since last year. It is brilliant... I don't forget anything and easily I can track my stiff The app that I'm using is Joplin. Open source and you can use it in any platform
soheil 5y ago
> I get free search if I use slack, which is a great upside That's a great upside? Any text editor has search. Any text area on any operating system has ctrl+f. I really don't understand why sometimes stories like this make it to the frontpage of HN. Yes, keep notes, write down those hard to remember commands somewhere so you can look them up later.
kaetemi 5y ago
I've tried wikis, markdown documents, cloud docs, etcetera. Eventually I settled on Word documents, shared over Resilio Sync. It's the easiest option to also allow images to be included, and to keep control over my own files. And the desktop and mobile editors are both equally reliable.
- Noumenon72 5y ago
  I really like Word's shortcuts to apply headings, and the built-in navigation pane that makes a clickable outline from the headings. I made a shortcut to apply "code style" and one to apply "comment style". Styles have been very useful as I decided to change the font size and indent over the years. Word for Mac is pretty slow, though. Takes 3-5 seconds to open a document after I hit the Karabiner shortcut for it.
quartz 5y ago
I'm so deep into Bear Notes that at this point it's basically a second brain to me. I used to heavily use tags inside documents for organization but slowly moved away from that and began almost entirely relying on search. The decrease in organizational overhead results in far more "quick jots" and reduces my ability to avoid writing things down because of not wanting to invest in setup time. The only big feature I really wish it had besides non-apple device access (if the bear devs are reading this PLEASE finish the web version!!) is a map view similar to the iOS photos app since it turns out I almost exclusively remember the things I write based on content or location. Interestingly I almost never remember WHEN I wrote something so the timestamps are pretty useless for content recall.
riston 5y ago
I am using also similar append only log like for every day, I usually try to write down the flows/random ideas/doing/done items there. I haven't brought in a structure overhead so everything is in a single file(couple thousand lines long) plain text file. My main idea is to keep everything sectioned by dates # dd-mm-YYYY # which is really great. I use sublime search and grep which works really great to lookup some older context and commands. Also going back to couple years old notes is really easy and valuable why some of the decisions were made. - KISS

226 points by brunooliv 5y ago

No one mentions indexing the content as a really important part of logging your notes?

I use simplenote for this. Mandatory for me is: - synchronisation across multiple machines - synchronisation on android - markdown - reasonable search - sorting by date Over the last few years I have tried many applications for this and many have failed. I really liked boost, but the whole paid/free/app/webapp mess with whole backups disappearing freaked me out.

ms123 5y ago

if anyone's interested in keeping a public log, i maintain smol.pub.

c_o_n_v_e_x 5y ago

I’m a product manager and keeping a decision log is a must for me. “Big” decisions / major changes getting logged along with the context of how and why the choice was made. Sometimes decisions get revisited and it’s nice to have all of your context, particularly if you are having to defend a choice that was made.

zuj 5y ago

I think any sort of memory dump, be it personal or professional is helpful. I used to write the morning pages and got out of habit and trying to get back. More than "cognitive offloading" as others mentioned it helped me in processing the past day. Never tried logging the work related stuff. Will give it a shot.

dSebastien 5y ago

I agree with this. I tend to remember a lot more when I take time to write things down. It was the way I studied, and is now the main way I learn new things. Writing can take different forms (written words or code), but in both cases, it makes ideas clearer, helps me create mental models, and help me shape my thoughts. I heavily recommend journaling and PKM in general. I recently wrote a few articles on the subject: https://dsebastien.net/blog/2021-10-07-periodic-journaling-part-1 https://dsebastien.net/blog/2021-10-07-periodic-journaling-p... https://dsebastien.net/blog/2021-10-07-periodic-journaling-part-2 https://dsebastien.net/blog/2021-10-07-periodic-journaling-p... https://dsebastien.net/blog/2021-12-03-personal-knowledge-management-organization https://dsebastien.net/blog/2021-12-03-personal-knowledge-ma...

fareesh 5y ago

What's a good tool that: 1) Loads in under 5 seconds 2) Is searchable, and can hyperlink to other entries 3) Syncs across devices

Eugeleo 5y ago
You can try obsidian.md

concombre 5y ago

I store my TODO list in a markdown file. I edit this with Vim and store this on a git repository. I realized some month ago, that the log is provided for free by git. If I run gitk, I can access all the history of task completion.

nefitty 5y ago
Oh wow I had never thought of this. My favorite method was to duplicate a daily task list in Evernote every morning, and resetting all the inputs. I'm going to automate that process now. You might have just solved the storage model part of my design. Thanks for taking the time to share!

Lhiw 5y ago

I keep a daily log of what I work on, i also drop other info links and notes. This is mostly to facilitate daily updates in lieu of stand ups. Another thing I do along side my todo.txt is log important team changes, team switches, people encounters, side projects and any major project milestones that might be useful to point out in my 6 month reviews. It's really amazing to search back and find links to things you did months ago when search won't pick it up.

matrixcubed 5y ago

I can’t recommend Joplin, synchronized with a cloud storage of your choosing, enough. Markdown, mermaid diagrams, tags, encryption. Everything I need to recall, on every computer I use.

Trufa 5y ago

I made a dead simple tool today for this purpose to try out svelte: https://dev-logs.netlify.app/ https://dev-logs.netlify.app/

slk500 5y ago

emacs org mode

syngrog66 5y ago

summary of the OA: note taking is helpful reaction: agreed. best practice and known as such for a long time I write notes in a plain text file for every project I work on. As I start to see things accumulate around a particular tool, technology or service (or any other common or cross-cutting concern), I eventually carve those note portions out of my per-project notes, clean them up and merge them into a notes file dedicated to that thing. I also look for portions of my notes worth extracting and transforming into executable scripts, complete with variables or templates where makes sense. Plain text notes are also easy to search, version and replicate around. Can upgrade some to Markdown or another structured text format where yields net value. Rinse and repeat. These habits yield increasing ROIs over one's life and career.

ahnberg 5y ago

This is such a valuable recommendation. I've been doing the same since 20+ years back. On and off I've been bad at it, but I always end up coming back and continuing. I think of it as more of a daily diary though, I mix random notes of things I've done, thought of doing, or interesting links and/or command-lines I've found useful so I don't have to reinvent them as often in the future. It has proven to be immensely useful for myself. Can highly recommend! My way is mainly org-mode files through Emacs over the years. Now having switched primarily to VScode I use a simplified org-mode version to get similar feeling, and it works pretty well. Everything is mostly text anyways!

whateveracct 5y ago

I have a few GitLab projects I use for this. Some are actual code things, and a couple are just for notes. I make issues all the time along with using the wiki.

michaelmcdonald 5y ago

The author mentions utilizing Slack for this; do so with caution. The free Slack tier only keeps 10,000 messages in history with the added drawback of now your knowledge stash is stored on servers with a 3rd party company rather than files you own / control.

neilparikh 5y ago
I think Slack actually keeps all your history, it just hides older messages from you. If you subscribe to the paid tier, you should be able to see the older messages.
brunooliv 5y ago
Thanks for the warning :)

adamnemecek 5y ago

It’s not writing that’s hard, it’s finding it later, and more importantly remembering that I wrote something down.

lijogdfljk 5y ago
Agreed. I wonder, what might be some mechanisms that would aide in finding things later? I feel like i often forget some keyword to find history items like this, but i _can_ find something near by. So maybe a way to narrow your history scope?
Taylor_ 5y ago
I have recently made the switch from using Mac's built in Notes app to using obsidian.md which focuses heavily on linking. It seems to be quite good for searching and recalling information. Although I have been using it for about 3 weeks.

jsguy 5y ago

1989 - 2007: notes.txt, 2007 - the future: notes.md

jcun4128 5y ago

I'm still wondering like where should it be. We all carry a phone with us. Seems like adding an extra thing (like earbud holder) sucks... servers "what if it went down"... At the moment I use different combos. I have made a few things, like a url-rest thing that's encrytped at rest where the entire website page body is a textarea element. Authenticated and unauth (local) versions. Desktop app. Phone note widget. One I'm working on is a chrome extension one since I use Chrome everyday. The main thing is it has to be made by me, ego. I used to use One Note but now I'm scared/cringe to look back at my younger self's thoughts ha.

jsemrau 5y ago

I use Evernote for this.

deleted 5y ago
[deleted]

pphysch 5y ago

I use Obsidian[1] pointing at a local directory of markdown files which is also synced across my devices via Syncthing[2]. Works flawlessly across my various Android/Fedora/Windows/etc devices. Cost: $0.0/year. I don't really use any Obsidian plugins. Obsidian has good builtin navigation, search, and markdown processing (e.g. LaTeX, code syntax highlighting). It's just as easy as opening a new file in $EDITOR, except its a markdown renderer & synced across all my devices. There are also a lot of bells and whistles like graph viz, export to website, etc. that haven't gotten in my way. [1] - https://obsidian.md/ https://obsidian.md/ [2] - https://syncthing.net/ https://syncthing.net/

number6 5y ago
I use the same setup + logseq. Gamechanger
- sbmthakur 5y ago
  What's the benefit of using logseq?
  - number6 5y ago
    Logseq has a build in query language. You can query every block of information. It's organised around blocks rather than pages. So you tend to organise your thoughts in packages. And you can reference blocks in your current page so you have a direct link. Though I think Obsidian does this to. The differences are quite subtle but profound.
    - sbmthakur 5y ago
      Understood. Do you use anything to sync data between both tools?
wodenokoto 5y ago
> I use Obsidian ... Cost: $0.0/year. For the use-case of a professional developer employed at a company with more than two poeple, it is $50.00 / year [1] [1] https://obsidian.md/eula https://obsidian.md/eula "Get a commercial license for each user" -> https://obsidian.md/pricing https://obsidian.md/pricing

joshlemer 5y ago

The easiest way to incorporate this into a typical developer's workflow is using the vscode-journal plugin: https://marketplace.visualstudio.com/items?itemName=pajoma.vscode-journal https://marketplace.visualstudio.com/items?itemName=pajoma.v... How it works: From any file, in any project, in VsCode just press CMD + SHIFT + J, select 'Today' and it will plop you into the journal page for today with today's date at the top.

staindk 5y ago
I've been keeping a 'work diary' in VS Code - tried a couple of simple notes plugins but I ended up just pinning my diary.md file in my main window... always easy to get back to it. I think the only other QoL I have for it is the markdown snippet I created that creates the current day's date and other boilerplate data when you type 'td'. It works really well for me, and I back up to a private git repo.

azaras 5y ago

Emacs org-mode is better than Markdown.

AceJohnny2 5y ago
+1 for Emacs Org-Mode. But of course you'd have to have bought into the Emacs ecosystem. Then again, Org-Mode may be a good first step!
- User23 5y ago
  Evil mode makes org-mode very approachable for anyone familiar with vim. Grab doom emacs or spacemacs if you want it to just work. Also, Elegant[1] is an attractive and simple config. It would probably be worth packaging it or something very similar up with CUA bindings and marketing it as just a standalone notetaking app with Emacs just being an implementation detail. [1] https://github.com/rougier/elegant-emacs https://github.com/rougier/elegant-emacs

abathur 5y ago

I find I always fail out of the append-only approach (even though I realize it means I'm spending more ~orgnizational time/energy). I can't claim to do it "regularly" in the sense that I do it every day, but I guess I do something like it in that almost every one of my projects has one or more PlainTask documents (i.e., documents that use org-mode-alike PlainTasks extension for Sublime Text). These documents usually start one day as a scratch space to remind me what I was doing before I take a break, or to plan out the next few steps. In any non-trivial project, it'll tend to grow to at least a few hundred lines, and almost all of them accrue a top-level section, at the top, titled KNOWLEDGE, where I (my better self, at least) try to record slippery or hard-won technical details I picked up along the way (even if I'm not smart enough to note them the first time or two I have to bang my head against them). I may not consult most of them again, but they can be a huge help when I get a chance to return to something that I had to back-burner 2 or 3 years earlier, and all of the critical detail has been displaced by newer ephemera...

nickjj 5y ago

Since about 2001 I used YYYY-MM.txt plain text files and have a shell script to help create notes in the most friendly way I could think of from the command line at https://github.com/nickjj/notes https://github.com/nickjj/notes. Totally works fine for a knowledge log when you're streaming high level details from your brain into text. I still use it today. The repo hasn't been updated in 2 years because it's a ~20 line script with a simple API that hasn't failed yet. But when you want to really go all-in with in-depth notes on 1 semi-broad subject it's tricky because in 1 month's time if you're hardcore deep in the woods of learning, applying and using something you're going to end up with hundreds of concepts from an assorted set of tools and it kind of stinks to have all of that info sitting in 1 file. Think about using something like Kubernetes. That's really Kubernetes, Kustomize / Helm, EKS, various cloud hosting details (networking, etc.), Terraform and ton of super useful commands / context. Details you for sure want recorded for later. For this type of info I've been building up a personal knowledge base with https://obsidian.md/ https://obsidian.md/. It's really nice and I highly recommend it. It's been working well for keeping things reasonably categorized without wasting a lot of time on the details around keeping links and tags up to date. It also has Vim mode that's good enough where day to day writing feels natural.

zephyr9 5y ago
Hate to nitpick but #!/bin/bash is not actually zero-dependency, as bash is not installed on BSD by default, and if installed won't be located at /bin/bash. You could probably just change to #!/bin/sh without issue.
- nickjj 5y ago
  Thanks for bringing this up. It does mostly work the same with shell but the -p flag of read isn't available with POSIX compliant shell. I ended up changing that slightly and pushed a patch to use sh now. Every other feature of the script worked the same with sh without modification. As for using #!/bin/bash instead of #!/usr/bin/env bash, that was an oversight from 2 years ago. I addressed that too in the above patch by using #!/usr/bin/env sh.
swansonator 5y ago

darkteflon 5y ago

I failed to do this throughout my first career. It’s one of my biggest professional regrets - perhaps the biggest. Reader, don’t be like me.

mtlynch 5y ago

I wrote a tool specifically for this, mostly inspired by the Snippets tool at Google. I've been publishing my weekly log in it every week for almost three years: https://whatgotdone.com/michael/2021-12-03 https://whatgotdone.com/michael/2021-12-03 The code is all open source if you're interested in playing around with it: https://github.com/mtlynch/whatgotdone https://github.com/mtlynch/whatgotdone

beembeem 5y ago

My append-only system for *nix, sits in my .bashrc: # Open Personal Logfile at end, optionally appending log entry for today if it doesn't exist function ed () { local _cur_date _most_recent_date; _cur_date=$(date +%m/%d/%Y); _most_recent_date=$(grep --color -o -E "^# [0-9]{2}/[0-9]{2}/[0-9]{4}" ~/${LOG_FILE_NAME} | tail -n 1 | cut -d' ' -f2-); if [[ "${_cur_date}" != "${_most_recent_date}" ]]; then echo -e "\n#\n# ${_cur_date}\n#" >> ~/${LOG_FILE_NAME}; echo "Command Comments" >> ~/${LOG_FILE_NAME}; printf "%0.s-" {1..81} >> ~/${LOG_FILE_NAME}; echo >> ~/${LOG_FILE_NAME}; fi; $EDITOR +$(($(wc -l ~/${LOG_FILE_NAME} | awk '{print $1}')+1)) ~/${LOG_FILE_NAME} } >>> # # 12/03/2021 # Command Comments --------------------------------------------------------------------------------- <some cmd> # My description of what cmd does, in my own words

jldugger 5y ago
a few months ago, some folks on HN pointed me at https://jrnl.sh/en/stable/ https://jrnl.sh/en/stable/

agambrahma 5y ago

Churned through a lot of ideas/apps for this over time, what works (not 'best' but 'well enough') for me right now is LogSeq. - Daily notes as roots - Local storage - Plain text storage - "wiki-links" - Backlinks and easily traversing notes - Hierarchical format for notes (with folding, so I can "tuck away" a bunch of text and screenshots when I don't want to look at them)

karencarits 5y ago
Me too! It's really nice, and integrated version control by git is great

decebalus1 5y ago

Ah.. time for the monthly note taking generic PKM HN post. Has nobody mentioned Zettelkasten yet? I see org-mode already made an appearance... Either way you go, don't forget to self-host!

asdfgeoff 5y ago
If it's not plaintext and client-side encrypted, is it even worth writing down?

ortusdux 5y ago

There is a documented phenomenon called the Photo-Taking-Impairment Effect, where taking photos of something can reduce your ability to recall details about it at a later date. It was originally theorized that it was a sort of 'cognitive offloading', but further tests have shown that reviewing and deleting the photos does not make up for the deficit. https://www.sciencedirect.com/science/article/abs/pii/S2211368117301687 https://www.sciencedirect.com/science/article/abs/pii/S22113... I remember finishing a complex math test in high school and checking my calculator's memory to find that I had done some rather simple single digit multiplication that I had no recollection of. Ever since then I've tried to be conscious of what I offload and what the long term consequences might be. For example, I'm confident that my ability to spell has decreased as spellcheck technology had advanced. I'm not recommending against keeping a log. In fact I keep several myself. I use google keep for simple things that I eventually want to forget. I use anki flash cards for spaced repetition study of short concepts that I want to remember. I use oneNote for sprawling interconnected datasets. And lastly, I used waldenpond.press to print and bind stories and articles that I want to remember and revisit. I just think that there is a risk to haphazardly externalizing more and more of your cognition. I started a new carrier 5 years ago, and found that many of my skills had atrophied over the years. I think I spent more time in my first 6 months relearning abilities I had taken for granted 10 years earlier than my new job duties.

smusamashah 5y ago
I dont know if this is what you are talking about but I have noticed so many times that when trying to recall an event I took a photo of, first image I get in my head is that photo. I try build the rest around that photo and it only works for very old photos/memories. For recent ones (e.g. photos of my newborn) I only see the photo in my head instead of the actual visual event. This makes me sad when I try to remember seeing him for the first time, I can only remember a few things and lots of photos. Now to mitigate that, I still take photos but avoid reviewing them immediately. I would rather go through them later when trying to recall. When I review immediately, it feels like the photo overrides the visual memory of the real event.
makeitdouble 5y ago
This study is interesting, but very narrow and might not be relevant to a lot of practical situations. In particular the reverse effect is observed on other subjects, manual note taking improving memory for instance. I think the important part here is that the “log” isn’t the goal nor something we are explicitely asked to do, but a step that comes after we experienced the work. I would compare it to taking photos of your own painting: arguably you wouldn’t be remembering a piece less because of the photo, you’ve been staring at it for hours/days in the first place.

_ink_ 5y ago

I very often fail in identifying the things that need to be added to the log. List running docker containers? So easy it's not necessary to log. That one obscure bug that took days to fix? So many things were tried that didn't lead to success, that the path to the solution is not clear anymore.

jldugger 5y ago

Five years ago I decided to buy rocketbook, which I use as a sort of journal. Obvious things go in there, like meeting notes & action items, but also notes from watching conference presentations, weekly Todo list tracking (ala bulletjournal), and outlines for phone calls I need to make (I find the preparation helps with the anxiety of making first phone calls, by collecting important data i might need and key points i need to accomplish ahead of time). I think I prefer the analog nature vs digital notes apps, and the scanner app helps with posterity concerns. Most notes are not that important a year from now! I used to take notes while reading books, but I've since moved that to part two of the system. For things where I absolutely want to remember something, it goes into Anki. While reading books, I make time to go over the chapters and extract key ideas into Cloze deletions. Helps with recall, and the Cloze format helps with recall since you're given far more context. And perhaps useful for search. For shell / computer stuff, keeping history around helps a lot. In theory important commands could become aliases or functions and kept around via git, but this is more rare. I do have a gnote / tomboy setup that I use mostly for long form writing, but that's less about journaling experiments & discoveries for later reference and more about getting plans and ideas out of my head so I can stop thinking about them, and drafting the occasional blog post.

brunooliv 5y ago

Glad to see this has ressonated with so many of you!! Thanks for all the amazing insights in the comments where, as always, a lot of the value lies.

pmulard 5y ago

Right now I'm trying to decide exactly how much information I should store in my knowledge base. There's a balance to keeping the base small enough to actually find the information needed and avoid it becoming a huge bloated mess. For example, I keep separate Notion pages for each programming language I use. I also recently started learning Rust and have built up a page that includes even basics like how to declare a variable. The idea was it can exist as a beginner guide and someone can run through it relatively quickly and get a jist for the language. But if I keep using the language, that information may eventually become obsolete (since I'll have it memorized) and will probably be a waste of space. Then as I advance through the language, I'll want to take note of more advanced concepts and maybe even some specific use cases of problems/solutions to code I'll have written. I guess that's the beauty of editing a knowledge base over time. You can edit it to conform what's in currently in your head right now. So maybe in a few years from now, having those simple variable declarations will be a waste of space and I'll just want advanced topics covered. Or maybe I'll walk away for a few years and need to look up basic syntax again.

teach 5y ago
In my experience there's not much risk of having a "huge bloated mess" so write more rather than less. I keep all my work-related knowledge in just a single flat text file, which after four years at my current company is just under 20,000 lines long and ~750 KB. It's easy to grep and so I can find virtually anything quickly. I think trying to get too fancy with organization could lead to troubles. A badly-organized knowledge base is hard to fix. Most of the time I'm just kicking myself that I didn't write down something that I was sure was in there.

simonw 5y ago

I've been using GitHub Issues for this for the past few years, and I absolutely love it. Each of my projects has issues. If I'm fixing a bug or working on a feature I open an issue for it, then I post a stream of comments as I figure out the details, make decisions, find examples of code that I need to use and so on. I have my own private notes repository which I just use for this for things that don't relate to a current project and that I don't want to publish yet. I add a "research" label to my repos, and open research issues for ideas or for things that I want to explore that are relevant to the project in some way. Recent example: https://github.com/simonw/sqlite-utils/issues/344 https://github.com/simonw/sqlite-utils/issues/344 - researching STRICT mode that was just added to SQLite, and seeing if it would make sense to support it in my sqlite-utils library. GitHub's issues API is comprehensive, so I have a cron that exports all of my issues and comments into a SQLite database that I can access with Datasette. I have a private one with all of my projects, and I also run a public one at https://github-to-sqlite.dogsheep.net/github/issues https://github-to-sqlite.dogsheep.net/github/issues with just the issues from my public Datasette-related projects. I use search against these often. I occasionally even re-discover old notes from Google searches, which include the ones from my public repositories. Many of my issues have dozens of comment replies, all from me. It's a great way of keeping a log.

_nickwhite 5y ago

I used to keep a huge Notepad .txt file of a ton of company knowledge, gotchas, offhand documentation, and any kind of tidbit that I might need later. A few years ago, I migrated all of this to OneNote with detailed, formatted notebooks for every broad subject I could categorize. I recently shared my OneNote notebook with guys relatively new to my team, and I found them using it all_the_time. So not only is the "Knowledge Log" good for you, it can also be a useful tool to help others on your team.

alexpetralia 5y ago
I've been doing the same exact thing for about 5 years now and I can't think of any skill I'd rather have than this one. I wrote more about my system here: https://news.ycombinator.com/item?id=25302365 https://news.ycombinator.com/item?id=25302365
errcorrectcode 5y ago
Awful solution. There are wikis. Dokuwiki is a simple one, or Mediawiki.
- narrator 5y ago
  At my old company, whenever anyone had a question about the system, we'd reply back with a link to a wiki page with the answer. It worked pretty well. We could either create the wiki page, update it, or refer to an existing one.
  - errcorrectcode 5y ago
    This is a good solution. That way, knowledge hoarding is often averted if the creator is willing to add info when it's fresh or lacking a procedure, and finder searches the docs before asking. I really hate the antique-mindset, amateurish shops where they don't use DVCS, wikis, or configuration management. "Oh yea, only Jim knows how that works" is one signal of intense knowledge hoarding.

rafalbel 5y ago

I can relate to that. Without my notes I'd be lost. Always trying to keep them simple and, if required, to make it accessible to others, to avoid creating tribal knowledge.

errcorrectcode 5y ago

Revision-controlled wikis are much more organized than some linear information overload or unsearchable paper bullshit.

dukeofdoom 5y ago

I started doing this for some software projects I wrote. I created a text file, and every time I fixed an issue, I would make a log entry. Notes what the problem was, what I did and how I fixed it. Since a long time can elapse between bug fixes, I tend to forget how things work. This is super nice to refresh my mind and saves lots of time.

defenestration 5y ago

To retain knowledge and my considerations for my future self and teammembers I create a document before each major task and update it during the task. The headings are: Goal (why are we doing this), Crux (what is the most important consideration, what will make the biggest difference), Current situation (where are we now), Steps (what needs to be done or what is done to reach the goal. The steps can contain specific details on how to get the step done) and Learnings (what did we learn, what are key insights). The files are named YYYY MM DD Taskname. Looking at the directory gives a sense of history. It’s a delight to find a document like this when doing the same task a year later. It also helps to delegate tasks to other teammembers.

decebalus1 5y ago
This! This is the way! I envy your coworkers. This practice is also one of the things that help me overcome chronic procrastination. For every project/feature/bugfix/etc.. I start with such a document in which I try to pin down exactly that. The goals (and explicitly calling out non-goals to fight off Feature Creep Frank[1] from the get go), the whys and the hows. The hows should be as detailed as possible. The hows/whys may be getting updated (with history, for this, I just strike through and add a date for the change, nothing fancy like revision history in the storage media). And whenever I feel like slacking off, the detailed tasks in these documents offer me a way out of a rut. [1] https://github.com/zsoltika/hacknot/blob/master/hacknot.md#feature-creep-frank https://github.com/zsoltika/hacknot/blob/master/hacknot.md#f...

efazati 5y ago

I started doing this, since last year. It is brilliant... I don't forget anything and easily I can track my stiff The app that I'm using is Joplin. Open source and you can use it in any platform

soheil 5y ago

> I get free search if I use slack, which is a great upside That's a great upside? Any text editor has search. Any text area on any operating system has ctrl+f. I really don't understand why sometimes stories like this make it to the frontpage of HN. Yes, keep notes, write down those hard to remember commands somewhere so you can look them up later.

kaetemi 5y ago

I've tried wikis, markdown documents, cloud docs, etcetera. Eventually I settled on Word documents, shared over Resilio Sync. It's the easiest option to also allow images to be included, and to keep control over my own files. And the desktop and mobile editors are both equally reliable.

Noumenon72 5y ago
I really like Word's shortcuts to apply headings, and the built-in navigation pane that makes a clickable outline from the headings. I made a shortcut to apply "code style" and one to apply "comment style". Styles have been very useful as I decided to change the font size and indent over the years. Word for Mac is pretty slow, though. Takes 3-5 seconds to open a document after I hit the Karabiner shortcut for it.

quartz 5y ago

I'm so deep into Bear Notes that at this point it's basically a second brain to me. I used to heavily use tags inside documents for organization but slowly moved away from that and began almost entirely relying on search. The decrease in organizational overhead results in far more "quick jots" and reduces my ability to avoid writing things down because of not wanting to invest in setup time. The only big feature I really wish it had besides non-apple device access (if the bear devs are reading this PLEASE finish the web version!!) is a map view similar to the iOS photos app since it turns out I almost exclusively remember the things I write based on content or location. Interestingly I almost never remember WHEN I wrote something so the timestamps are pretty useless for content recall.

riston 5y ago

I am using also similar append only log like for every day, I usually try to write down the flows/random ideas/doing/done items there. I haven't brought in a structure overhead so everything is in a single file(couple thousand lines long) plain text file. My main idea is to keep everything sectioned by dates # dd-mm-YYYY # which is really great. I use sublime search and grep which works really great to lookup some older context and commands. Also going back to couple years old notes is really easy and valuable why some of the decisions were made. - KISS