Ask HN: Where do you keep your Knowledge Base?

36 points by AhtiK ↗ HN
For years I've used things like self-hosted wiki (mediawiki, TracWiki etc), Atlassian Confluence, and lately just a Github wiki to note down things I or team mates might forget and having a place to keep a structured knowledge.

It all still feels clumsy, no longer want self-hosted services and they are all somewhat hard to edit&navigate.

Are you happy with your solution for sharing with the team mates&storing your knowledge for easy retrieval? What is it?

19 comments

[ 3.5 ms ] story [ 60.0 ms ] thread
It's a semi regular question and search for personal knowledge base or personal wiki on HN gives a few previous discussions with lots of pointers to software.

Three months ago "Ask HN: Do you keep a personal knowledge repository?" with 100+ comments https://news.ycombinator.com/item?id=20007108

The focus of that post is about personal stuff, where things like suggesting Emacs, plaintext, evernote etc is appropriate, but far from what I'm looking for :-)

I'm looking for something that also works within the teams.

Like GitHub wiki but less clumsy&in-place editing. Got one hint from your suggested thread - Notion, maybe that would work.

I keep a git repo of a 'commonplace book', which I prune to plain text, and keep scraps of various texts - short tutorials, poems, a password vault, and usage examples. The same repo gets loaded at home and work, and so those examples are available to each other.

One subdirectory is more magical, 'data/cheatsheets/<filenames>. If I run a bash function 'cheat $1' with the filename, it will just dump the file into a pager like the less command.

When I fizz out on how git works, I run 'cheat git' and get my own notes. I can edit it when something ends up being useless to me, and keep the most important stuff at the very bottom. Eventually it gets drilled into my head and I learn it.

This scales to one person very easily. The value is the subjectivity. With some actual editing, this would also scale to a small team of maybe 4 people.

Of course, most of the stuff in my repo would not be appropriate for sharing, but the model would extend in general.

I have an alias in git called "cheat" that will return a page of useful notes I've written (for myself).

I find it funny that I type "git cheat" where you type "cheat git".

I like your technique better, as you can easily add more technologies to the mix.

What happens if you type "cheat" with no parameter? Does it list all of the cheat sheets? (i.e. ls data/cheatsheets/*)

I'm in the same boat, I decided to turn all the features ive hard coded into my wiki (dokuwiki) over the last few years into a standalone fresh, from scratch, file manager with wiki journal capabilities.

I sort of outlined some key points here: https://tumblr.macleodsawyer.com/post/187317505027/file-mana...

* Making this for myself, but might open source it. Should be able to run independent without server, or on a server for cloud capabilities accessed through a browser since it uses a flat-file structure with a json registry of file names and metadata for collections and records.

Let me links to a previous discussion on this topic: https://news.ycombinator.com/item?id=17892731

Are you talking about knowledge storage for you personally or within a work context?

Mostly work, but simple enough for personal use.

Ask HN title was somewhat misleading, because it comes from a place where I have to organize tons of content that potentially gets shared to and collaborated with the team.

I guess something between Confluence and GitHub Wiki would work. Ideally with an in-place editing and enough hand-holding when it comes to linking existing pages&headings.

I am perpetually changing this up, but the one constant is workflowy. Things like a cars Vin number, small notes like shell one liners, all the way to large categorized outlines for projects. It takes some getting used to, but the key lesson is for a great many things - text as individual files per subject is not the right metaphor.

I wish they would support an official api, and it kills me that the native desktop app is an electron thing, but all the ways they have not fucked it up in the last 10 years is what makes it worth looking at.

I have a nagging fear that as a VC funded (yc I think) company they will have to sell out eventually.

After going to the Workflowy site I have no idea what it does other than look like a less-colorful OneNote. It's good the App Store requires screenshots to be submitted, because that's the only place I could find any.

What does Workflowy do that's so great?

I've been rocking NVAlt (with SimpleNote on my iPhone) for a while now. It's just a basic note application but I use it for scratch space, quick notes, gift ideas for friends/family, etc. It's my person central knowledge base (even though it's not organized great, it's more of a knowledge dump). I'm not particularly attached to it to be honest but any replacement would have to meet the follow criteria:

* Light - I don't want "yet another electron app"

* Hotkey-able - I need to be able to assign a hotkey to quickly show/hide the UI. This ONE feature is huge for me and changed how I used NVAlt once I mapped Ctrl+1 to show/hide it

* Mobile clients - iOS needed, android would be nice

* Sync service that I can trust OR using iCloud/Dropbox as a backend

I'm half-considering attempting my own notes app (for the desktop and maybe iPhone) once Swift UI ships since NVAlt doesn't do a ton so I can't imagine it would be terrible to re-implement. I would like to add some minor features to it (Maybe basic to-do list or scheduled reminders) and fix the damn smart quotes thing (I have been bitten too many times from making small tweaks to code/json I throw into it for just 1 second and the quotes being those stupid smart quotes).

I started using https://histre.com/ a few months ago and I love it and would strongly recommend it. I can easily save information in notes, which has the option of being connected to a link or not. Then I can easily access the notes I created using tags I create myself (I love that it uses autocomplete!). Histre supports easily sharing your knowledge with others. You can share a single note with anyone, whether they are a histre user or not. You can publish a note just by tagging it with #pub (see https://histre.com/pub/valeriemettler/ for an example). You can also create a team and have a shared notebook where the entire team can have one central place to share and access useful information on any given topic. I recently got my team at work to start using it and they absolutely love it!
I have a folder called "TIL" (today I learned) and under that I have one folder for each technology/topic. Every time I learn or do something that I need to remember, I create a new markdown file in the relevant folder (or create a new folder). Most of this I publish to the internet, at https://TIL.secretGeek.net

To publish it all I have to do is push.

I have a private repo too for TIL's I don't/can't share (and all passwords go in a password manager)

At work we have have a custom in-house wiki that stores all of our shared internal notes.

Give Notion a try. I came across it in one of these threads on HN and have been loving it.

It basically feels like if Slack made a wiki.

I have a folder `~/Projects/KB/<Subject_Area>/' with the usual subfolders:

- Documents: my notes, Anki flash card files

- Books: Related to that subject area

- Sources: one off PDF's, or PDF exports of interesting articles on the web

- Papers: that I read related to that subject area

- Code: which contain git repos of code that is related to any of Books/Documents/Sources/Papers.

The idea is all related to one 'Subject_Area` in one directory. I have a large private KB directory hosted on `Gitlab` and backed up to the cloud/2 local disks.

One of my customers told me that they use my Helpinator for this. It allows to generate a static HTML knowledge base that they update from time to time and release to co-workers. It's mosty HR inner company instructions stuff. It's not that I recommend everyone to use it that way, but it's a fun experience to know that someone uses your tool in a way you never thought of.
Zim Desktop Wiki for personal needs(although it supports a local web server) and Wikidot for hosting online.