Live data from Hacker News

Ask HN: How do you share/organize knowledge at work and life?

news.ycombinator.com

41–50 of 304 posts

Re: Ask HN: How do you share/organize knowledge at work and life?

#41
post #9

Earlier quoted context omitted.

Is there an org-mode editor besides Emacs that has a lower learning curve?

Yes, my favorite is the one I built myself which look like this: https://demo.filestash.app/view/emacs.org?share=hn It can create entire wikis by rendering documents in many formats: For example: - HTML: https://demo.filestash.app/api/export/hn/text/html/emacs.org - PDF: https://demo.filestash.app/api/export/hn/application/pdf/ema... - markdown: https://demo.filestash.app/api/export/hn/text/markdown/emacs... - txt: h…

This looks really nice and quite useful, you should do a Show HN! (By the way, that first link doesn't work)

Re: Ask HN: How do you share/organize knowledge at work and life?

#43

I try to use Jira whenever I can. It sucks. But the thing is everything else also suck so for me Jira sucks a little bit less.

Apart from being pretty slow, I don't think Jira really sucks once a) it is configured to your needs b) you know how to use it (which should be fairly easy with a in place). Which goes for pretty much any tool more complicated than notepad, so to speak: it's not like the other similar tools out there are much better, just different, imo. Though I have the impression a lot of people who think Jira sucks might be using it where they actually don't need it because much simpler tools could suffice in their particular situation.

Re: Ask HN: How do you share/organize knowledge at work and life?

#44
Mediawiki works quite well. Most people use Wikipedia, so are able to quickly learn & use Mediawiki. Wikimedia Foundation has a number of initiatives to increase the diversity of Wikipedia contributors, so that translates into features non-technical people in your org will appreciate.

Microsoft was using Mediawiki for external-facing developer docs (at least on the HoloLens site), but after the GitHub acquisition has switched to a workflow that uses VS Code as a Markdown editor & publishes to GitHub pages. That kind of workflow can be okay if all the people in your company are highly technical.

As your company grows you may get value out of internal conferences or mini TED style talks.

Video & screen recording can really help too.

Re: Ask HN: How do you share/organize knowledge at work and life?

#45

I use an outliner called Dynalist. It’s an alternative to Workflowy. Workflowy development stalled a while ago so I switched but it seems to be active again so I might switch back. An infinitely zoomable hierarchy works really well for my OCD :)

Another alternative is TreeSheets (http://strlen.com/treesheets/) which is desktop only but very fast and nice implementation of structured note taking tool. It's very well suited as replacement for mind maps, categorization of items and mapping hierarchical structures. I prefer it to any online solution because of speed and data ownership.

Re: Ask HN: How do you share/organize knowledge at work and life?

#46
Over the years, I've tried everything from MediaWiki, Evernote, OneNote, Confluence to Google Docs. Each seems awesome when you start out, but after a while, the novelty wears off and out-of-date crud starts accumulating.

The only thing that has remained constant for me are text files. I use two forms: if it's related to a component I'm developing, I tend to place it in the repository itself, in README.md, or docs/.md. Other stuff I keep in text (.md) files in a Dropbox.

Only those things that don't fit well into the above two formats go into Confluence.

Re: Ask HN: How do you share/organize knowledge at work and life?

#47
Notion: https://notion.so

[edit: I work at Notion. I’ve added some more color about that to the top here. This isn’t marketing spam I’m commenting from bed on my phone - sorry that it came off slimy]

Notion is a malleable collaborative wiki that also has relational databases.

We build Notion, so it figures that Notion is our single source of truth. I think the way we use Notion internally works pretty well - with better results than the smattering of tools I’ve used at other companies - but we’re a smaller team...

Notion makes a good wiki because adding, editing, and organizing information has such low activation energy. Each part of the org (Eng, Community, Marketing, People, ...) has a tree of pages with process, information, etc.

We have a few big centralized databases that everyone uses:

- Tasks. Lets us see what anyone is doing, assign tickets, track progress.

- Documents. This one has a weird name. All teams put meeting notes, research, proposed designs, RFCs, specs in this database. The common thread here is that documents are artifacts of their time: they’re authored, reviewed and commented on by the team, iterated on, then ratified or archived. We rarely change them afterwards because they store historical context on decisions. If an RFC changes a process, or a design gets implemented, the affected team(s) might update their wikis.

- Goals. Stores objectives, product use-cases, and large projects. We relate Tasks and Documents with the Goals they support.

Centralizing these databases fosters cross-team visibility and assists with collaboration, eg seeing Eng and Marketing tasks related to an upcoming launch, plus the designs and research.

Shortcomings:

- Search. At the ~50 person size it isn’t a desperate problem but it does hurt.

- Integration with email and calendar. There’s no way to sync Notion to Gcal or react to incoming emails.

- Integration with Github: none.

- Mobile performance could be better.

[Disclaimer: I work at Notion.]

Re: Ask HN: How do you share/organize knowledge at work and life?

#48
post #33

Create a knowledge-team whose sole job is to take information from all the other teams, digest it, and make it available to the rest of the firm. Call it "corporate communications" or "internal marketing" or whatever floats your boat. If you can't get a proper department, at a minimum you can get a on-staff librarian who is a good technical writer who you can pass around the firm (as long as they have the ear of the…

In a programmer environment, this is impossible. A programmer will always need to document his own things for a simple reason: (s)he is the only one who really knows. Putting people in the middle of that who can barely understand all the details, seems like a lot of overhead for a worse deliverable.

Re: Ask HN: How do you share/organize knowledge at work and life?

#49
I use Markdown documents in Git repositories whenever I can. Also try to evangelize for this at work. PRs then include relevant changes to both code and docs and it's beautiful. For personal project docs I use this exclusively. At work it depends on the team, some people don't like it, but most often it is because they don't like keeping docs at all, not because of an alternative preference. I avoid UI and WYSIWYG based systems like Confluence like plague. I personally can't stand them and every time I have to use one I do my hardest to pretend I'm writing Markdown in my head.

For personal agenda I use Apple Notes with basically just a huge list of things to do and events that are about to happen and I curate that list more or less non stop during the day. If something comes up and I'm with people and don't want to be rude and spend too much time on the phone editing things to be in the right order and have all the relevant info captured with them, I just plop a line at the top of the note knowing I'll groom it later.

Re: Ask HN: How do you share/organize knowledge at work and life?

#50
post #47

Notion: https://notion.so [edit: I work at Notion. I’ve added some more color about that to the top here. This isn’t marketing spam I’m commenting from bed on my phone - sorry that it came off slimy] Notion is a malleable collaborative wiki that also has relational databases. We build Notion, so it figures that Notion is our single source of truth. I think the way we use Notion internally works pretty well - with bet…

Hey I've been using Notion at work and its great so far. Do you know when will the api will be ready by?
Post reply on HN