Page 1 of 1

Eclectic Light: "We need to document macOS"

Posted: Thu Aug 17, 2017 8:46 am
by josehill
An interesting post about the decline in the quality of Apple's documentation -

https://eclecticlight.co/2017/08/13/las ... ent-macos/

(The author is Howard Oakley, who has written some very nice utilities, like the Consolation log browser for macOS Sierra.)

Re: Eclectic Light: "We need to document macOS"

Posted: Thu Aug 17, 2017 11:42 am
by uunix
josehill wrote:An interesting post about the decline in the quality of Apple's documentation -

https://eclecticlight.co/2017/08/13/las ... ent-macos/

(The author is Howard Oakley, who has written some very nice utilities, like the Consolation log browser for macOS Sierra.)

Gone are the days when you took a technical manual to bed and leafing through the pages, thinking, mmm that sounds good.. is it worth getting out of bed and firing up the machine.

I don't know if he is correct with apple, but working on a Microsoft platform, I know that, I tend to by-pass Microsoft pages and get far better honest answers from other sites from real people.

Re: Eclectic Light: "We need to document macOS"

Posted: Fri Aug 18, 2017 2:24 am
by Shiunbird
uunix wrote:Gone are the days when you took a technical manual to bed and leafing through the pages, thinking, mmm that sounds good.. is it worth getting out of bed and firing up the machine.


+1 on that
When I was a kid and we would go to the farm, dad would not let me always take the computer (tower, CRT, model M, mouse, heavy machinery), and I would bring the manuals instead. I think I've read the Windows 95 and the DOS 6.22 manuals 1000x times. They were just deliciously written and well illustrated.

We had an IBM Aptiva at the time, not the best computer ever, but the hardware manual was so good as well, wow. I still have it somewhere around.

Re: Eclectic Light: "We need to document macOS"

Posted: Fri Aug 18, 2017 7:13 am
by ClassicHasClass
Mac OS X Internals is a great read, but it's 1) not written by Apple 2) limited to 10.4 and earlier, though this is perfectly fine with me (typing on a Tiger iMac G4).

Apple only supports developers to the minimum extent software can actually get written. Even their TNs and other documentation before, haphazard as it was, had better coverage than now which is basically annotating the header files.