Live data from Hacker News

We need to document macOS

eclecticlight.co

41–50 of 266 posts

Re: We need to document macOS

#42
>> "I am also daily reminded of Apple’s wholesale failure to provide consistent and complete documentation of its flagship product."

The author of this article fails to realise that the Mac is not Apple's flagship product anymore...

Re: We need to document macOS

#43

Better: We need to stop using undocumented proprietary systems like macOS.

Or maybe abandon strictly ideological and polarizing standpoints, accepting that most people are productive in different ways than our own, and conceding that not giving a damn about distros, dependencies and command line interaction doesn't make you a evil operator of the IT Satan?

Re: We need to document macOS

#44

Just in case no-one read the leaflets that came with their new Mac, Apple has fairly comprehensive macOS documentation online: https://support.apple.com/macos A lot of this is built into your Mac also, at Help > Mac Help in the Finder. For those who prefer physical books, I've always found the "Missing Manual" series to be excellent.

Do they? I don't think the OP (or me, for that matter) is looking for documentation telling him where to click in the UI. The article seems to be about more low level stuff.

Re: We need to document macOS

#45
post #39

Earlier quoted context omitted.

> "but a really terrible choice on the desktop" This is a very subjective claim. Maybe a long long time ago you could say this, but not the case today. > "not convinced that free software documentation is any better" That's beside the point. If that were true, that is an argument for focusing a community effort at improving documentation for a free desktop. And actually with linux the problem is not as much a lack of…

I shouldn't have to go to terminal to edit a conf file to make audio or video work. I have every single time I have tried Linux on the desktop. It does not work out of the box. You must know how to use terminal and edit Byzantine configurations, and read Linux forum posts from 2005 to make basic functionality work. It's my "subjective" opinion, but after 5+ hours troubleshooting and configuring as a power user who do…

That's it though, it very often does just work.

Without vendor support and with barely any investment from manufacturers, the Linux community is still pushing on to get things to a point where your dog could install it.

Your experience is an anomaly they're trying hard to eradicate.

Re: We need to document macOS

#46

Earlier quoted context omitted.

There is no undocumented open source software, the documentation is just in a technical language. This is why learning to program is important, as it also means learning how to read the documentation. I'm not being factious. We always say that documentation doesn't keep up and that the only real documentation is the code. Ultimately the only reliably documented software is free software.

You're totally being factious in favor of free software. Not facetious, though, I agree. To your actual point, what hampers free software more than anything imo is a lack of focus on usability. People buy Apple because, less now than a few yeara ago but still the vast majority of the time, it Just Works. People buy Creative Cloud for much the same reason, and Office 365, and whatever other proprietary products you ca…

ElementaryOS seems to be going in the right direction. But I suppose the main "thing that works" is to have a team of people that actually enjoy making software usable by the masses rather than solving X for their own needs.

Re: We need to document macOS

#47
post #39

Earlier quoted context omitted.

> "but a really terrible choice on the desktop" This is a very subjective claim. Maybe a long long time ago you could say this, but not the case today. > "not convinced that free software documentation is any better" That's beside the point. If that were true, that is an argument for focusing a community effort at improving documentation for a free desktop. And actually with linux the problem is not as much a lack of…

I shouldn't have to go to terminal to edit a conf file to make audio or video work. I have every single time I have tried Linux on the desktop. It does not work out of the box. You must know how to use terminal and edit Byzantine configurations, and read Linux forum posts from 2005 to make basic functionality work. It's my "subjective" opinion, but after 5+ hours troubleshooting and configuring as a power user who do…

Audio has "just worked" for years now, thanks to PulseAudio. Video was a mess for a while, but now it will generally work great out of the box if you've got Intel or AMD graphics. Nvidia is still a mess, but Nouveau will work fine for non-gaming stuff.

Re: We need to document macOS

#48

Better: We need to stop using undocumented proprietary systems like macOS.

In contrast to undocumented free (open) systems? Documentation is an issue irrespective of prorietariness(??!) of a system. I welcome this initiative. (Yes I know there are examples of documentation excellence to be found in some free/open systems. You can advocate their use whilst also having well documented macOs.)

Straight from the article:

> Most open source projects are proud to have user documentation which is an order of magnitude better than anything provided by Apple for macOS.

Re: We need to document macOS

#49

OT a bit but I think still related. 8 years ago when I switch to OSX I was furious with finder. Tiny window, no hierarchical browsing and the search just doesn't do shit that is useful. I normally default to locate or find now so much that I was using it the other day I was reminded about how much it sucked. It's literally identical (aside from tags and labels) to what it was forever ago and is a terrible paradigm. I…

A beefy windows workstation or laptop to cover Adobe & DAWs + VMWare for Linux. With fullscreen VMWare and open-vm-tools I can barely notice that it doesn't run bare metal, and i can keep different distros at hand for different purposes.

Re: We need to document macOS

#50
Open-source documentation (PRs requested!) on macOS security & privacy: http://www.oss.io/p/drduh/OS-X-Security-and-Privacy-Guide

"... a collection of thoughts on securing a modern Apple Mac computer using macOS (formerly OS X) 10.12 "Sierra", as well as steps to improving online privacy. This guide is targeted to “power users” who wish to adopt enterprise-standard security, but is also suitable for novice users with an interest in improving their privacy and security on a Mac."

Post reply on HN