Hacker News new | ask | show | jobs
by Shanedora 2781 days ago
I haven't needed my notes that often but on occasion I do and that's usually when I'm glad I took the time to keep a engineering journal.

I accomplish this with a jupyter-notebook inside a git version controlled repository. I'll usually write my notes down in markdown format. Markdown is nice for me because it forces me to write clean/formatted/organized notes versus just writing random stuff down in a word doc. Jupyter-notebooks work great for me because much of my scripting is done with python. So I can include snippets of python code if I want as well as share it with my friends/colleagues.

Our company has an internal server that hosts the atlassian tools such as confluence/bitbucket/jira/cruciable. Each of us in the software department have our own company bitbucket account. Therefore, I keep my jupyter-notebook hosted on my bitbucket account.

For personal use I have moved away from paper/pencil journals. I usually collect my notes in the same way or sometimes just in a text file that I organized in their own dedicated git repositories on my GitLab account. Usually it's a project per project basis. For example, I version control many things in my home directory on my Linux computer like my bashrc/bash_profile/vimrc/zshrc and files alike. This gets consolidated in a "My_Linux_Setup" with other notes of mine of what packages and libraries I need to install should I need to reimage my computer.

1 comments

How often do you review these notes? And do you use any tools besides grep to search through them?