News for hackers. Stuff that matters.
Re:Ask HN: How do you share/organize knowledge at work and l... by tomashubelbauer on Monday October 21, 2019 @04:52AM (#21310356)
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 l... by vendiddy on Monday October 21, 2019 @05:33AM (#21310525)
I do this too. I use Sublime text in distraction free mode with a git plugin so I can easily commit/push changes.

On my Mac, I can do the 4-finger swipe to check my full-screen notes. Usually I have a folder structure like notes/2019-10/2019-10-21.txt. If I want to tag things, I'll just write #idea #work somewhere in the text file.

Then easy to search with Sublime or whatever tool you want. I also like this approach because it's future-proof. Just a folder full of text files.

Curious how others are handling this same workflow.

Re:Ask HN: How do you share/organize knowledge at work and l... by synlatexc on Tuesday October 22, 2019 @11:15AM (#21324570)
Same here, though mine is one gigantic text file that dates back ~20 years.

Expect to continue updating/referencing it for decades to come, bar some calamity.

Re:Ask HN: How do you share/organize knowledge at work and l... by doomjunky on Tuesday October 22, 2019 @08:43PM (#21329959)
How? Chronologically or structured by topics? Appending at the top or buttom? Timestamps? Tags? How do you navigate through the file?
Re:Ask HN: How do you share/organize knowledge at work and l... by synlatexc on Wednesday October 23, 2019 @09:53AM (#21334633)
There are a couple sections, but for the most part it's chronological, with new entries at the bottom. Started adding dates to new notes/quotes/observations about 5 years ago.

It's a sprawling mess, so I rely on search to find what I'm after.

I reference it often -- it's like an extension of my brain.

Re:Ask HN: How do you share/organize knowledge at work and l... by 64738 on Sunday October 27, 2019 @02:05AM (#21368107)
I do the exact same thing. Just a text file that these days I store in a Dropbox folder so that no matter what system I'm on I can just "vi ~/Dropbox/notes.txt".

Similarly, several years ago I added a keybind to my .vimrc that, by typing ",a" I'm moved to the bottom of the file and today's date with a separator line underneath. My leader key is "," and I mnemonically associate "a" with "append".

The earliest date recorded in it goes back to 2006 and is about 300KB in size. I still reference and add to it on a regular basis.

Re:Ask HN: How do you share/organize knowledge at work and l... by bluenose69 on Monday October 21, 2019 @05:11AM (#21310436)
This is pretty much exactly what I do, too. The only difference is that my use of Apple Notes is mostly for quick, personal things ... I move material into Markdown documents within git repositories as soon as I can, because then it's easy to share it, trace changes, and organize contributions.

Oh, and one more thing: my Markdown documents are normally R-Markdown documents, so I can incorporate calculations and graphs as needed. (Also, R-Markdown has a nice metadata section for document title, author, date, etc.)

Re:Ask HN: How do you share/organize knowledge at work and l... by johnminter on Monday October 21, 2019 @07:23AM (#21310963)
I, too, am a fan of R-markdown for this purpose
Re:Ask HN: How do you share/organize knowledge at work and l... by tonyoaky on Monday October 21, 2019 @05:25AM (#21310495)
Do you use any specific structure for your markdown documents? Confluence i believe helps structure the knowledge
Re:Ask HN: How do you share/organize knowledge at work and l... by thundergolfer on Monday October 21, 2019 @05:40AM (#21310535)
But Confluence crucially isn’t source-controlled within the same repo. It’s not source controlled at all.

I find this a terrible workflow problem. As often a change to code requires a small or large change to documentation that is best bundled in alongside.

Re:Ask HN: How do you share/organize knowledge at work and l... by tmaly on Tuesday October 22, 2019 @10:19AM (#21323839)
It does have change history of each page. However, if you use a lot of embedded tables, it is quite hard to do change comparisons.