Archive for September 16, 2020

Wednesday, September 16, 2020

Authoring Mac Help Books in 2020

Mario Guzman (tweet):

Apple’s own documentation for Apple Help has moved to the documentation archive on their developer site. You’ll find tons of questions on Stack Overflow and other… more questionable sites. Apple did do a minor revision to their documentation back in 2013. 2013!!!

By now, 2020, Apple Help is neglected and well, crusty. Very crusty (no, not that Crusty). It still works but certain parts of it don’t seem to work as well anymore. Not sure why it’s neglected. They advise you include a Help Book in their HIG that was recently published — and they link to the documentation (from 2013). Personally, I think they have a lot of potential and a lot to offer. I just wish this was a component at Apple that would get some attention in both development and documentation.

[…]

I spent countless hours and days trying to piece together all the information from all corners of the internet to build a Help Book. It was super frustrating and excruciatingly time consuming. I don’t want anyone else to feel this way so I hope this speeds things up for the next Mac Developer who wants to include a Help Book with their awesome app!

I prefer the hiutil command-line tool over the Help Indexer app because I can invoke it from my build script.

Previously:

Tageslicht 1.0

The Coding Monkeys:

If you find yourself frequently in the vicinity of great TV screens with AirPlay support, this app is for you. For us and our famlies it has become second nature to just project our foto library onto them to have a great group experience. However, every now and then we want to show something physical too. But if you just mirror the built in camera or loupe app, you never get a pleasant result. Black bars, incorrect rotation or the touch interface icons overlaying everything.

With Tageslicht you now have a great experience streaming your camera so it fills the screen, is low latency, and shows exactly what you want it to show.

What’s Left to Do After Migration?

Adam Engst:

During the setup of the new iMac, I had no issues migrating all my data from the Samsung T5 SSD that I had been using to boot the old iMac, but I was somewhat surprised at how much additional work was necessary afterward. The promise implicit in Setup Assistant’s migration is that you won’t have to reconfigure everything and can just get back to work.

It’s a nice idea, but in reality, there are numerous areas where Setup Assistant simply doesn’t—and probably can’t—save you from additional work. All of these relate to how the underlying identity of the Mac has changed, even if its name and the names of all the drives in play remain the same.

[…]

However, there are also a few instances of apps that have requested permission to something on the old Mac that did not migrate to the new one.

Wikipedia Matters

Marit Hinnosaar et al. (PDF):

We document a causal impact of online user-generated information on real-world economic outcomes. In particular, we conduct a randomized field experiment to test whether additional content on Wikipedia pages about cities affects tourists’ choices of overnight visits. Our treatment of adding information to Wikipedia in- creases overnight stays in treated cities compared to non-treated cities. The impact is largely driven by improvements to shorter and relatively incomplete pages on Wikipedia. Our findings highlight the value of content in digital public goods for informing individual choices.

Via Ethan Mollick:

Adding two paragraphs of text & nice pictures to randomly selected articles about small European cities led to an over 9% increase in hotel stays; the edit is worth $190k per year!

Ethan Mollick:

As any academic will tell you, influencing the direction of science through research is hard... so here is an easier path. One quality Wikipedia article written by chemistry experts influenced the content of 250 published peer-reviewed academic papers!

Wikipedia is an MMORPG (via Hacker News):

One theory that explains the addictive nature of Wikipedia and its tendency to produce Wikipediholics is that Wikipedia is a massively multiplayer online role-playing game (MMORPG). The following article explains how Wikipedia shares many characteristics with MMORPGs.