[masnick]

I have a personal "knowledge base" that is publicly available at https://maxmasnick.com/kb/.

This is partially inspired by Chris Albon's excellent data science technical notes: http://chrisalbon.com.

I find it very helpful to have this kind of information on a public website. It's easy to search myself, quick to edit[^1], and helpful for sharing with others when someone asks me a question.

For notes I don't want to make public, I use OneNote. It's available on every platform, has a documented file format, and the sync works well. Of course, I have some more detailed notes on why I prefer this to other options: https://maxmasnick.com/kb/note-apps/.

[^1]: My whole website is built with https://gohugo.io. I use the GitHub Actions beta to automatically update the public site every time I commit to master. This means I can edit on a computer with a standard text editor, and also on iOS using https://workingcopyapp.com.

[pbhjpbhj]

I got excited then for OneNote on Linux (Kubuntu) but a quick search suggests it's only available with a few hacky kludges and WINE?

[shorts_theory]

I use OneNote on KDE Neon in a Windows 10 virtualbox. Yes, it's not the most efficient but I have found this approach much faster than using the sluggish web UI for OneNote. I also use my Windows 10 virtualbox for the rest of the MS Office suite through a university subscription, so I feel it justifies the 30GB of disk space it takes.

[kuzimoto]

There is OneNote online, it's a little slimmed down from the desktop app though.

[Weizilla]

How do you backup OneNote?

The link to where you explain it is broken: http://protips.maxmasnick.com/backing-up-onenote-notebooks

You mentioned it as being a critical feature but from what I've been reading, it's pretty complex and tricky due to it's weird syncing rules and relationship with OneDrive. The only decent solution requires a Windows version. See: https://answers.microsoft.com/en-us/msoffice/forum/all/good-...

[dshacker]

I usually use this way of exporting Notebooks for personal accounts.

https://support.office.com/en-us/article/export-and-import-o...

[danesparza]

Dropbox. Basically, you can create a new notebook and all pages under that notebook are organized in a directory hierarchy. I've done this for just under a decade without issue.

[masnick]

Sorry about the bum link (it's fixed now).

The simple answer is you can download zips of the entire OneNote notebook from the OneDrive web interface.

[tryptophan]

You are able to print entire notebooks as a pdf. Its not the best, as text can be cut across pages if you don't originally fit into nice-paper sized areas, but it does export everything quit easily.

[Jeff_Brown]

I am impressed. Whenever I try to build a tree of thoughts, I run into the problem that I want things to fall under multiple categories. I might start by classifying them according to subject area (as you have done), but then I might want a collection of those notes to also fall under "could help with project X" or "would be of interest to person Y" or "can be learned from reference Z" or any number of things.

[teamonkey]

This is a use of AI I've not seen yet, to sift through soups of knowledge, categorise it and make judgements on what else is related and relevant

[rubicon33]

Isn't that what tags are for? Search by tag?

[iamwil]

This is what links were originally invented for.

[kevinslin]

really like your knowledge base and your build process.

i've been experimenting with personal knowledge bases for much of the last decade and have settled on a homegrown solution that involves ten thousand markdown files. notes are organized as trees with a top level domain (eg. aws, programming, finance, etc) and finding a particular note is a tree traversal down the tree. the main goal is speed and structure - want to access anything within my knowledge base in seconds and have a coherent way of modeling knowledge even as it scales past ten thousand notes

recently quit my job to build this into a service. would love to get feedback from people with similar challenges: http://demo.alphacortex.io

[deca6cda37d0]

“ I use the GitHub Actions beta to automatically update the public site every time I commit to master.”

How do you set that up?

[masnick]

It's somewhat convoluted and custom to my specific hosting setup (I use https://www.nearlyfreespeech.net because I want an Apache server so I can use complex redirects). Essentially, the GitHub Action builds the site and then copies it over to NFSN. This is all done in a Docker container.

The only potentially interesting part about this setup is I take advantage of this git feature I didn't know about until I set this up: https://git-scm.com/docs/git-worktree. This lets you essentially check out a branch into a folder in a repo. Hugo can then build the site in to the special folder, and the built site is committed just to that branch. I then push this branch to NFSN, rather than using rsync or scp, which takes a lot longer for small changes compared with sending a git delta over the wire.

I plan to write up a more extensive description of this when GitHub Actions come out of beta. If you want to hear about it when it comes out, you can subscribe to my blog's newsletter: https://masnick.blog/subscribe/

[stoolpigeon]

If it's not too much to ask, I would add on here that I'd like to see your Hugo setup. I've been learning it recently but the examples I find are all rather simple. Just seeing what you've done gives me some ideas of how you did it, and I'll work on figuring it out - but information on how you organize things before hugo generates the site would be greatly appreciated.

[hieloz]

You can refer to GitHub Actions for Hugo https://github.com/peaceiris/actions-hugo

[all2]

You could instead use Gitlab with their CI/CD tool: https://gitlab.com/pages/hugo

[rhlsthrm]

I haven't tried GitHub Actions yet, but Netlify makes this very easy to do.

[jppope]

Very interested in this as well. How do you do automatic deployments?

[Grzegrzolka]

Yes! I tried multiple things in last 15 years, everything but OneNote failed me in one way or another.

[spencerwf]

I agree with this. However, the only annoying thing is it copies and pastes text as a photo. I’ve stared using outlook email drafts as a place to put rough notes. They are searchable, they sync with the cloud and copy/paste works as expected. Give that a shot if you want.

[brianzelip]

Good to see a UMB alum here. Who uses Tachyons no less! Thanks for the tips.

[masnick]

Hi, thanks!

[Havoc]

Out of curiosity how much traffic does the personal kb get?

[masnick]

Essentially zero. It's not well-advertised, and I only started it in earnest earlier this year.

My Technical Notes blog (https://tech-notes.maxmasnick.com), which is a similar idea but much more random in content, does get a fair bit of traffic on specific pages, presumably via organic search traffic. (This is the most popular Tech Notes page, which has had 30k views over the last 4 years: https://tech-notes.maxmasnick.com/ipython-notebooks-automati...)

[arunc]

No mention of KeePass under password managers?!

[masnick]

I'm only interested in password managers with good desktop, web, and mobile support.