skysight-inc/HackerNews huggingface dataset:
Why bother? If the people making the thing can't be bothered documenting it you're going to fight an uphill battle. In the long run, for better or for worse, code is documentation. If the code isn't available there'll be only so far you can go. And with the unification of iOS and macOS fast approaching the number of people able to have transparency into even just the POSIX layer is going to drop another order of magnitude.

macOS is dead, Apple just hasn't told anyone about it yet. And iOS 11 is going to be it's murderer.

If you have the time to document, you might as well spend the time documenting Windows, BSD or Linux; Blink or Servo. Or the JS ecosystem.

The Apple specific SMB implementation or APFS or Cocoa are not worth documenting any more than OOXML would be - only as a specification that one party has the power to change and to implement. There is no way for the documentation to be considered prescriptive rather than descriptive for anyone touching the code. It might be useful in some limited aspect for a limited time, but it will decay as Apple considers every single pixel their OS is going to render to be under their control in some way. Apart from what they can sandbox, which amounts to the web platform, which is plenty documented already.

> launchd – second only in importance to the kernel – controlled and orchestrated most of the services supplied in macOS

Who cares about the launch facilities in macOS when anyone who should care about launch facilities is going to be using Windows Server, Linux or BSD? Apple couldn't have been saying fuck off to anyone wanting to screw around with CUPS or Samba or launchd more loudly unless they shouted it from all the rooftops in Cupertino.

> Magic Trackpad 2, never knew how to launch an app from the Dock, or couldn’t manage their Photos library.

1. It'll stop working (here we go, top result for a Google search: https://support.apple.com/en-us/HT204621) 2. Launchpad exists and has a keyboard shortcut and 3. Photos manage themselves. What does manage even mean in the context of you take a picture with a phone, it adds geotagging and a time and that's it. What more do 99% of users want?
I've seen patches in production code that amount to 20 if else's to handle specific inputs rather than the correct input.

I just inherited a system that uses trim everywhere on everything because originally they didn't sanitise the inputs.

Rather than hunt down all the inputs they just did trim(foo) == trim(bar) making it worse is that it's PHP and so not only do they trim things but they type-coerce them, good luck trying to reason about that 7 layers deep :|
How is that an acceptable response?

A hypothesis must be falsifiable for it to be valid in the first place, and saying "the Sun did it" is a valid way to falsify the hypothesis; thus you now must also prove the Sun is not affecting climate change to the degree that we have measured.

No one has been able to prove this, and all evidence collected by NASA seems to indicate that the Sun is by far the largest driver of climate fluctuations on Earth, even during the modern age, not humans.
I mean, I'm not the target audience and I don't have the attachment to OSX as a platform, but if I was gonna expend the energy to document a thing, I'd hope it goes towards a good cause and isn't just free labor for like the richest corp I can think of from the top of my head.
Nice. Very funny videos
Yeah,

- only some people

- occasionally

- along with all other types of food making tofu a very small portion of the diet
If it turns out that this type of DMCA use is legally valid, adblockers could be modified to reject pages that embed URLs that have filed such requests.

So if a particular site uses admiral to protect its ads, it loses traffic.
This problem is actually the reason I've fallen out of love with Macos as a platform for my home computers.

There's way too much stuff that goes around, daemons that are waking up at any given point and doing a lot of I/O, for which there's absolutely no documentation whatsoever.

It kills the performance on my old Macs and also doesn't inspire confidence that I'm a user/owner of the device.
The extraordinary story of Britain’s efforts to finance the First World War
The Mystery of S., the Man with an Impossible Memory
Same here. I've tried so many other clients. Mutt(which is obscenely overrated and shitty), mu4e, various GUI clients like Thunderbird, etc, etc.

The only thing that really works is notmuch. It's so much easier to just lump all your mail together, and then tag it appropriately based on the content or whatever.
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.
Apple's primary focus and the source of money is iOS. That is why macOS has to be 1) just noticeably better than competitors 2) inconvenient enough for average users to partially migrate to iOS.
Not exactly a podcast but America: Empire of liberty by David Renoylds is a masterpiece.

It can be listened like a podcast as each chapter is self contained and 10 mins or so with first hand accounts from actors etc.
I can code in Julia, Python, R and Matlab. It's just the ignorance of some from the AI field. R and Matlab might be good for prototyping but not for long running stable web server applications. Julia is still too new. Python syntax has spaces part of the syntax. And Python destroyed the community by splitting it in half - 2 and 3 are still around more than a decade later and many projects will never upgrade to 3, but moved on to Go.

Lua is used in Torch. Some are in C++. Unfortunately too many entry level samples are in Python. It's like the JQuery plague was to JavaScript not too long ago, when every other question on StackOverflow was answered with a slow as hell JQuery snip instead of vanilla JavaScript. Good that people moved on. I welcome the same for Deep Learning.
> In contrast to undocumented free (open) systems?

There's choice so you don't have to use those - https://www.freebsd.org/doc/handbook/
This is Apple we are talking about.

If you built a knowledge-base like this on your own time and for the right reasons I bet they send a DMCA.
This was to be expected. All history books are written this way. History books are government propaganda. History books do not document the truth. History lessons are nothing but propaganda. So history at school is nothing but learning government propaganda.
They don't care, better to lose legit content than advertising dollars.
Trees who suffer from drought apparently give off ultrasound when their dried cells are destroyed, but it seems to attract pests who then finish off the tree: https://www.thefreelibrary.com/Pop+chirp+bite+crunch+chew%3a...
Non-centralized churches are interesting. They are institutions that generally rely on community funding. They have the potential to easily last beyond any one person's lifespan, hopefully many generations. They are places where people meet not only for religious purposes, but also to gather, chat, and eat.

They are places where new parents trade knowledge and assistance. They are places where young people contribute their physical labor and tutoring abilities. Some churches directly provide daycare and tutoring services. Religious leaders often take on many hats, one of which is counselor to young people.

But how do you create churches without religious glue?

Or, how about even more basically, how do you convince people that it's worth building more publicly funded community meeting spaces for young and old, such as parks?
DDD was always for me the only sane way to use GDB. Until I got hold of it, I was mostly using it from Emacs.
DFS+Fanduel+MLB+Picks+8/13/17:+DraftKings+Top+2+Pitchers
New deep learning course by Andrew Ng
Thanks for this. I tried radical personal finance, the episode 'what's wrong with radical personal finance' is very good!
Is sugar toxic? (2011)
What is at all elegant in UNIX style file systems?!

Windows is as open as OS X, HP-UX, Aix, Solaris, OS/400, ....
I would like to see an AI based search engine. So if I search on something it gives the CORRECT results back, not some SEO'd results and almost always useless. A search engine like this could make Google search looks like outdated tech.
>If you built a knowledge-base like this on your own time and for the right reasons I bet they send a DMCA.

Why do you say that? Your post makes me think I'm ignorant of Apple's past litigation.
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.
We used to be open to paying for quality tools, then the FOSS generation took over, killing the business of selling tools to single developers.

Nowadays the only way to make money selling developer tools is to sell them to enterprises, the only ones that value developer time vs money spent on tooling.
20th century sci-fi: Attack of the Martians

21st century sci-fi: Attack of the aliens from TRAPPIST-1
Pay in cash

Lately I've been wondering whether I should withdraw most of my money from the bank. Any serious drawback to that approach? For one, I don't like my transactions being tracked and two, find it outrageous I have to pay various fees to use/access my money while it is used to enrich others.
I hope the author of this site is proud of their fixed-position page header. Because it takes up fully 1/4 of the screen height in my browser.

Just sayin'.
Nah someone just needs to gift Donald Trump a fat stack of it and it'll be recognized as genuine legal tender in no time.
I doubt it. What claim would they have over a non-fiction work they had no hand in creating? They could sue for other reasons but the judge would have to be a fucking idiot to do anything other than order Apple to pay court costs. How much software documentation has been written by third parties?
> [ ] Record/post video of you reading the post on YouTube.

Lol, really? I don't see the benefit of doing that. It's way faster to read text than to watch a video.
That's a Google search .... hardly news.
> The changing nature of the planet Arrakis is key to understanding the themes of the Dune series.

Indeed -- this was one of his goals when writing the series.

http://www.salon.com/2015/08/13/dune_climate_fiction_pioneer...
Given an object with a length property with the type a method expects, is there ever a scenario where the method is incorrect?

I'm trying to wrap my head around it: if a method needs only the length property, which is an unsigned int, is there any good reason why it shouldn't accept any object that has that property?

It appears at first that this is a good quality: the code is general whilst obviously avoiding any type errors, including null/undefined errors.
Haven't used it in a while, but I think this public should also take a look at TeXmacs. I've long stopped caring about anything WYSIWYG but that software seemed to me to strike a very well designed balance between WYSIWYG/fast-input (though with a steeper learning curve than M$Word, but very approachable) and showing what's under the hood.
And use what? Windows spies on you and they call it a feature. Linux is a great server OS but a really terrible choice on the desktop. I'm not convinced that free software documentation is any better, either.

macOS is the best desktop OS going, for the moment.
The hardware peripherals are one time costs not monthly. But Roku sticks are $60 each and the AppleTV's (third gen) were $59.
Can Sarahah Avoid the Disasters That Doomed Other Feedback Apps?
Documentation effort towards OSX would help vastly more people than similar efforts for any flavor of Linux, which nobody plus epsilon uses (except amongst devs).

Impact is a big factor in how useful an activity is, even if it's tied to a big company.
> In contrast to undocumented free (open) systems? Documentation is an issue irrespective of prorietariness(??!) of a system.

Windows and Android had much better documentation than Linux for a long time.

That is one of the major reason of why they are where they are nowadays.
Owner's suite

son's room

home gym

wife's sitting area

Family room

Guest bedroom
I think the root of that is the high reliance on teammates and the level of commitment each game takes. Unlike League there is no early surrender, so if you’re in a rough game you have to endure the full duration which can last around an hour. If you feel like it’s your teammate, who is probably randomly paired with you, that is failing it’s easy to get frustrated. This is one of the many things that make Dota either extremely frustrating or extremely satisfying.
CFS is an umbrella term for a range of symptoms. I find the research into psychoneuroendocrinology very interesting, it's on the frontier of examining how our minds interact with our body to maintain a 'state', for example, it was recently discovered that bone marrow plays a role in the communication between the brain and the gut microbiota, we are a 'closed loop' system, our gut microbiota causes changes in our brain, our brain causes changes in microbiota.
It starts off nice, but past the blog part, it seems to just be mixing some low quality things with the high quality stuff.

Something like "Attend meetups or conferences for your target market" can be extremely dangerous because this is a great way to spend a lot of time accomplishing nothing just to tick something off the list. Whereas something like "cold calling 20 customers" is so important it should be in bold.

I would recommend this to be a list of marketing ideas depending on your phase, rather than an actual checklist of things to do.
On the other hand, Twitter is less and less relevant, on it's way to bankruptcy.
Third possibility: we do not exist either.
If you haven't already, join the MacAdmins Slack. https://macadmins.herokuapp.com
It's an open-invite slack team with over 12000 users - sysadmins, MDM developers, security researchers and so on.

We have various ongoing efforts to document and improve the macOS experience for users. If you have a macOS question, you'll likely find the answer there.
I just have the feeling that the author is trying to explain OOP with the vocabulary of 1974.

What did you find interesting in this paper?
"What's new today that they may not have foreseen is the vast level of internetworking and human communication that arose from ubiquitous presence of computers and networks."

In an alternate universe, Godel published his proofs in a paper on arXiv in 2002. However it was largely overlooked or dismissed as the work of a crank, so he went back to his day job at MSR.

A casual reference to the paper in a comment on on Math Overflow five years later led to wider discussion and eventually to Scott Aaronson publicising it on his blog. Within a year the two theorems were accepted by the global mathematics community.

Since then, numerous blogs, subreddits, and Facebook posts have challenged the legitimacy of the proofs or claimed prior credit. Speculation persists on some parts of the internet that GCHQ or the NSA knew of the theorems as early as the 1950s.
i don't think we are close to general ai, but bitcoin is a key ingredient for AI being independent. Currently, electronic banking requires a human in the loop, even for corporations.
> I've reduced my annual train fares bills from over 11k to under 6k

That is nice for you, but neither of these numbers is something that National Rail can pride itself on. In Germany for instance, a "Bahncard 100" that lets you travel everywhere anytime without pre-booking costs about £3.5k - and in addition, you save the dozens or hundreds of hours spent "hacking" the fares to get screwed ever so slightly less...
I think a more common example would be Googling a daemon that's hogging memory or CPU. Ideally, the top result would be Apple docs with a clear, concise description. In practice, it's usually an Apple discussion thread (which I do give some credit for them hosting/maintaining) or Stack Exchange. Although, I don't think I've ever seen an official response in their forums. It's usually a meandering set of posts (and "me toos!") before I can get any description of what it is or how to address it.

Sure, the average person doesn't have Activity Monitor (or top) open, but they could be walked through that process when their fans blare and battery life nosedives.
I can't really go along here. Sure, getting into a relationship with someone who's reasonably compatible with you will do a lot to ameliorate loneliness. But getting into a relationship "no matter the cost" is not a good way to find someone reasonably compatible with yourself, and being distracted from feeling lonely by the many other problems such a person can bring is not really the same as no longer feeling lonely. You just end up lonely and miserable.
I was trained as an engineer and the abstract part of maths used to bug me a lot. We were often told to just accept them as they are, that just like everything else they add to your Toolbox. My biggest bugbear is imaginary numbers, can't seem to get my head around what they are but I accept that this is due to my limited imagination. Well I read that they can't be imagined because it's a human construct - honestly I don't know what to say or think.

Bucket of negative apples, hmm. I feel slightly sheepish to say this but I immediately visualised it to be "a bucket that you intend to put n apples in, but didn't." Thank god I'm in a semi-technical field now :D

Edit: language.
Church of England or the Unitarians might be non-religious enough for you?

(I'm not a Christian, so can't say too much.)
still, why not use machine learning to tweak the script instead of starting from scratch.
it depends from the market. Cold calling can be effective in the us but should be done with a lot of attention in Germany for example, or Europe in general. Here we are all much more skeptical towards companies or individuals that call you to offer something. Most of the time, even if the call is perfectly crafted and polite you would be perceived as an obnoxious spammer.
Didn't want to diminish your comment, because I agree completely, but I think it's important to point that out for readers who might not operate in the States
> "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 documentation, but rather that the documentation is a little overwhelming, because it is just too specific or technical. (ever typed "man" something in a terminal?)
“The children now love luxury; they have bad manners, contempt for authority; they show disrespect for elders and love chatter in place of exercise. Children are now tyrants, not the servants of their households. They no longer rise when elders enter the room. They contradict their parents, chatter before company, gobble up dainties at the table, cross their legs, and tyrannize their teachers.”

Socrates supposedly said that already over 2000 years ago, similar sentiments have probably been around for thousands of more years.

Elders demand respect and locality (follow in our footsteps) on account of their age and experience, while youths demand individuality and freedom to pursue their dreams and passions, it's bound to clash.
Have you seen any bots perform competitively with human pros in Dota, even in the easier 1v1 case?
No I just contrast them.

One group is subjected to ultra efficient capitalism.

Another group can benefit from a myriad of complex tax breaks, government deals, revolving door relationships between legislation and business, ZIRP, NIRP and when things get really dangerous for them: outright bailouts.

Not all mega-corps depend on all of these unfair perks. I actually have a rather positive view of SV and the tech sector. They derived huge benefits from ultra loose monetary policy over the last few years (Amazon included), but they also do some genuinely great stuff.

That's why I said it goes way beyond the tech bubble.
How come I never see them come up in Google searches? I have seen it come up when looking for conditioning your battery or the shortcut keys for Target Disk Mode. But more often I'll search for a runaway process name or an OS message that is spamming Console. The top results are Apple Discussion posts that go on for pages, but often don't have a clear result. I also recently was trying to learn more about macOS' init system and got lost like the article mentioned.
Gotcha! Thanks for the explanation!
I don't disagree with you, but I feel this misses the point about technical documentation. Code tells you how something works, but it doesn't tell you why it works that way - which is often just as important.

Unless we start writing paragraphs of comments for every little five line function, there will still be a need for technical documentation outside of code.
Great, I would be interested on how you built the dataset/database.
Please share when you have the post.
I recently started using Qutebrowser[1] on OpenBSD, and it's really, really good. There's a learning curve but it's well documented, and help's easily available. If you use vi, you'll feel right at home.

[1] - https://qutebrowser.org/
The difficulty of dealing with CFS might cause depression, but apart from that depression does not have to do anything with CFS.

Anti-depressant and psycho-therapy are the two best treatments for depression though, everything else is just experimental.

Why do you think that mild depression does not fit the symptoms? In its early stages, you only have lack of drive and 2 more of its 7 side symptoms. (these are the diagnosis criteria for mild depression, look it up)
Weight change of SD-Cards
If they rely on you (you being apple here). It's their fault for relying on undocumented interfaces. Consequently, they should stop using your system but they don't.
To the author, did you file radars listing specifics of which areas you need documented? https://bugreport.apple.com isn't just for bugs.
And the overflow check is now finally cheap in portable C. Before you had to use inline assembly for this trivial ex:

add %rax, %rbx
jo +4

Now you have the new gcc and clang overflow intrinsics (gcc-5, clang-3.4), which made it cheap and easy to use proper and precise int arithmetic, promoting int to bigint's only on overflow.
iPhone+8,+a+week+of+rumors+and+concepts+of+the+next+Apple+terminal
Welcome to the new world :)
Code is the end result of a thinking / problem solving process, not the process itself. If I implement a mathematical formula in code, the “documentation” is the academic paper where the formula is described and proved, and the whole context of textbooks and other papers where the relevant terms are defined and abstractions are constructed, not the handful of lines of abstract arithmetic on one-letter variable names in the code. If I throw away the paper, the code doesn’t suddenly become self-documenting.

If you’re going to make such a reductionist definition of “documentation”, why not go all the way: every executable program is just a sequence of clear and simple instructions to the machine. The documentation of what each instruction does is right there in black and white. Why would you need anything else? All programs are documented.