Live data from Hacker News

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

news.ycombinator.com

171–180 of 304 posts

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

#171

I work in a team closely related to another team, and together we're about 30 people in the midst of THOUSANDS of engineers responsible for shipping product. We are dying under the burden of tracking and correlating engineering decisions across product lines and customers through presentations (you can't have a meeting without PowerPoint!) and spreadsheets -- scattered all over internal shared drives -- email, and Sk…

I've used Confluence with teams of hundreds, and it's ok.

It is reliable, flexible and has a pretty good search which works when you have multiple access levels. It's a bit clunky sometimes though.

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

#172
Documenting / sharing what you collect at work and at life are two different things. Usually platforms used at work requires enterprise sharing, security and authentication capabilities whereas the ones you use at home don't need to have those.

At work:

* Confluence (http://confluence.atlassian.com)

* Balsa (https://getbalsa.com) - this one is open source, can be deployed on premises and has several security features - think of it like Evernote replacement but you keep your company files with you.

For personal use:

* Sublime text (when I don't need any sharing among devices)

* Notes (if I need to exchange data between my iphone and my laptop)

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

#173
I actually launched https://ulluminate.com to help with knowledge sharing. I found myself looking through my bookmarks far too often to share things with friends and coworkers. I wanted a tool where I could segment my bookmarks into private, shared, and public spaces and provide annotations as to why I thought the link was helpful. Also the ability to search a link and domain across the network of public bookmarks will be really cool for discovering like minded people and subjects.

I still have A LOT of work to do on it, but the goal is to make it really valuable for team and peer communication. I think if you use a bookmark extension to navigate your organization's structure, it should stay more up to date than a wiki (at least thats my hope).

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

#174

I would suggest a single source of truth. In my marriage, it’s my wife’s google calendar. My personal projects are in a single google doc with tags I search for. I document my personal projects because sometimes I do stupid stuff and wipe out my work on accident. For work, We use confluence as the source. We have daily stand ups that go on there. For any screenshare 1v1s I create a quick doc to cover what we discusse…

> We use confluence as the source. We have daily stand ups that go on there. You record your stand-ups on Confluence? I think retrospectives should probably be recorded (on something - Confluence I guess if you're using it) but stand-ups? Genuinely curious if you think you get any value from this? How often are they referred back to?

I imagine each team member writes down their status in a daily page.

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

#175
I'm a stickler for well-written tickets.

In general: All products have a few pieces of information that must be clearly provided in a bug report (or support escalation.) For my product, (desktop file sync,) this includes build version, unedited log files, filenames, and clear steps to reproduce.

Industry-wide, a clear ticket title that is more than "XXX doesn't work," that uses known product terminology, is also important. [Edit] Also critical is that information that defines what the ticket is, such as clarifications, and updating the steps to reproduce, shouldn't be buried in comments. Edit the ticket description.

Poorly-written tickets, either because they are missing agreed-upon information, like log files, or because they just don't explain what the problem is, are sent back. I tell all my engineers to regularly look through their tickets and send anything back that's confusing; so once they are able to work on the ticket, everything they need is there.

Another critical thing: It's important that tester follow good practice for your specific product. I've had testers attach videos, but ignore log files. Videos might be very useful in a product that the tester worked on in an old job, but they very rarely are helpful when trying to diagnose why a file isn't uploading. (That's why we have logs.)

The final critical thing: Managers must respect what engineers need in tickets. This means that the testers' manager should be instructing testers in the specific items of information that they need to collect for your product. If a manger doesn't respect the fact that you need logs (or whatever else you need) present in every bug report, your problem isn't communication. It's that you have a manager who doesn't respect the needs of your business.

[Edit] Why is it important to be a stickler, and make sure that tickets are well written? When you have to look at a LOT of tickets, you don't have the time to read through 100 comments in each ticket, and then spend an hour trying to reproduce the ticket just to understand what the problem is. If you have a lot of tickets that don't make sense within the first 60 seconds that you look at the ticket, then you need to figure out how to improve ticket quality.

Another thing: Don't combine bugs into the same ticket. This happens when testers start doing things like failing verification because they found a new bug. (Does the ticket refer to the new bug or the old bug. How come, when I follow the steps to reproduce, I can't reproduce the bug?) This also happens when testers think that the same bug has multiple steps to reproduce. It's always easier to close a bug as a duplicate, than the fix one bug in a ticket and keep the ticket open for the other bug.

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

#176
post #143

I rely heavily on https://workflowy.com/ Here is a quick interactive demo: https://workflowy.com/list-maker/ But I'm not sure how well that works with 50 people. You should probably mention what kind of knowledge you want to share and what features you might need.

Second workflowy. There are other zoomable nested lists (e.g., dynalist), but they're too slow. Workflowy forces minimalism, which ensures your data is portable and that the handling of it is fast.

Adding colored tags[2] and the Workflowy Code Formatter extension[1] makes it really great.

[1] https://chrome.google.com/webstore/detail/workflowy-code-for...

[2] https://chrome.google.com/webstore/detail/painter-for-workfl...

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

#177

I am starting a new venture and will use BookStackApp ( https://www.bookstackapp.com ) as my single source of truth. It is searchable, offers markdown and WYSIWYG editing, page templates, and is quite opinionated on how to layout things. My reasoning for this is to layout basic templates and processes for sales, support, ops, and office management. This is also used to lay a foundation for ISO 27001/27002 compliance…

Love bookstack. Thanks for sharing.

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

#178

I am starting a new venture and will use BookStackApp ( https://www.bookstackapp.com ) as my single source of truth. It is searchable, offers markdown and WYSIWYG editing, page templates, and is quite opinionated on how to layout things. My reasoning for this is to layout basic templates and processes for sales, support, ops, and office management. This is also used to lay a foundation for ISO 27001/27002 compliance…

Well, I just found BookStackApp yesterday after months of searching. Then imediatelly installed it in my small company. Now, we're migrating from Paper to BookStack and it looks very promising.

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

#179

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…

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

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.

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

#180

I work in a team closely related to another team, and together we're about 30 people in the midst of THOUSANDS of engineers responsible for shipping product. We are dying under the burden of tracking and correlating engineering decisions across product lines and customers through presentations (you can't have a meeting without PowerPoint!) and spreadsheets -- scattered all over internal shared drives -- email, and Sk…

I'm pretty sure every company I've ever worked at has been in the middle of trying to fix their document management & sharing. It's all sucked.

The overall best knowledge-base I've ever used has been... Slack :-(

Email is probably second-best but suffers from too much spamminess—"here's a progress report you don't need, for that project you're kind-of on part time, sent once a week, to pollute your search results for same project if you ever actually need anything, oh and there'll be a 20-reply thread here which may or may not contain anything worthwhile to anyone at all, good luck sorting wheat from chaff". Plus if you have both Slack (or similar) and email Slack's more likely to have the Real Stuff, and email may miss out on entire topics.

Post reply on HN