4 ms·
Totally OT rant, but here goes: > Even then, I still used some of the FreeBSD Handbook to learn Linux, because Debian didn’t have the great Reference that it d
by krylon 9y ago
Totally OT rant, but here goes:
> Even then, I still used some of the FreeBSD Handbook to learn Linux, because Debian didn’t have the great Reference that it does now.
At work, we are pretty much a Windows shop, and I am often frustrated by the state of Microsoft's documentation. Some parts, say, .Net API reference, are pretty good. Reference material for SQL Server is quite good, too (and I will am very grateful for that, because I have to deal with SQL Server a lot).
But in other parts, documentation is crappy or non-existant (I am looking at you, SharePoint!)
to such a degree that sometimes I wonder if they do this on purpose to generate business for the hordes of consultants and authors to write books (although all the SharePoint books I have looked at, sucked, too - the only helpful search results tend to be the blogs of SharePoint consultants, those poor souls).
And when people tell me to stop ranting because that is just the way things are, I tell them to look at the FreeBSD Handbook. Or the OpenBSD documentation. If these projects that are largely volunteer-driven are able to supply such excellent documentation, why can't Microsoft?
Okay, enough with the ranting, let me close on a more positive note: I run my home server on FreeBSD, mostly because of ZFS, but I have come to appreciate jails and bhyve, too. I love it, because it has not given me any trouble. It was straightforward to install and set up, and once it was working the way I wanted it to, it just kept going. (I check for updates regularly, of course, but that does not take much time, and I would have to do that on any other OS, too.)
- biohax2015 9y ago> But in other parts, documentation is crappy or non-existant (I am looking at you, SharePoint!) to such a degree that sometimes I wonder if they do this on purpose to generate business for the hordes of consultants and authors to write books Very likely. See: Oracle.
- equalunique 9y agoI would say "See: IBM" but sometimes their documentation is brokered by their sales division, so there isn't anything to see for many.
- combatentropy 9y ago> I wonder if they do this on purpose to generate business It's ironic that money can make a product worse.
- zombieprocesses 9y agoIt's why planned obsolescence features so prominently in the modern world.
- zombieprocesses 9y ago> At work, we are pretty much a Windows shop, and I am often frustrated by the state of Microsoft's documentation I have to agree. Every job I had after college was a windows stack shop while my college/personal experience was purely linux/bsd. Microsoft's documentation has always been terrible. My assumption also was that they did this to sell training, books, etc to customers. But as you noted, they have improved in recent years. Their .Net and SQL Server documentation is very good. Still wish that microsoft didn't have such a stranglehold on corporate america and we could live in a unix-based world.