I can't believe I'm going to say this, but this sounds like an actual problem well-suited to a blockchain solution.
380 karma · joined October 14, 2019
I can't believe I'm going to say this, but this sounds like an actual problem well-suited to a blockchain solution.
The goal is "please write your documentation." What solution has the least friction around that for engineers? Right now, it's overwhelmingly Markdown.
It's not perfect, and often doesn't provide the features a technical writer or other content specialist might want, but it handles most use cases and is something developers are willing to write in.
So please, write your documentation in whatever you feel like. As long as it gets written.
I can't stop myself from eating an entire of package of Oreos if they're in the kitchen. So I don't buy them. I don't give myself the choice, because I know I'll make a bad one. Instead, I choose to restrict my choice (and the choice of the rest of my household) for our overall well-being.
This feels pretty bad if you're a 10-year-old and just want some freaking cookies. Sorry you weren't able to make your own choice there. Our overall well-being took priority over your individual liberties. I get why that is unacceptable to some folks, but there has to be some balance, and sometimes that means restricting personal liberties in order to maintain the health of the overall system and community.
Remember, the problem is "I need to know when I don't have two managers on the floor," not "how do I use machine learning to know when I don't have two managers on the floor."
No brand or PR team that I've ever been near has the capacity to monitor and then manually downvote this kind of thing, even on major sites, let alone a niche news site like HN. Who has the budget for this?
Imagine delivering that feature and expecting to get a larger salary because of where you live? COL is either a thing or it isn't. Job markets are localized because of physical presence. Once you take that limitation away, the artificial inflation of Bay area salaries fades a bit.
Small chunks of information that piece together into a larger whole along a narrative timeline is the go-to document method of pretty much all of tech.