Open Radar

 
Summary:
Dear Documentationeros,

The position: fixed headers in Release Notes documentation pages hides important information.

Consider the AppKit Release Notes for macOS 10.13, found here:

https://developer.apple.com/library/content/releasenotes/AppKit/RN-AppKit/index.html

This page has a link titled “Layer-backed Views”. Since my app uses layer-backed views for some pretty important features, and since I started getting mysterious layer-related crashes when I tested my app on macOS 10.13 (see rdar://32698202), I was pretty interested in this section of the release notes. So I dutifully clicked on the link. I didn’t find anything relevant to my crashes. Fortunately, I attended WWDC17 and was able to talk to AppKit engineers who diagnosed my problem and explained the change in AppKit that caused my problems.

I later discovered that this change *is* documented in the “Layer-backed Views” section of the release notes, in a paragraph titled “Stricter allocation of view-backing layers”! So why didn’t I see it? I didn’t it because it was covered by the position: fixed headers. Please see the attached video. Here’s what’s in the video:

1. I start at the top of the AppKit Release Notes for macOS 10.13 page.
2. I click the “Layer-backed Views” link.
3. The “Stricter allocation of view-backing layers” title and paragraph are *not* visible. I have no idea that I’m not seeing the critical information *to which I clicked a link*.
4. I use the Safari debug tools to hide the fixed headers.
5. The critical information *to which I clicked a link* is now visible.

Please fix the documentation layout so that the target of a link actually becomes visible when I click the link.

Thanks,
Rob


Steps to Reproduce:
 

Expected Results:
 

Actual Results:
 

Version:
Version 9.0 beta (9M136h) / 10.13 Beta (17A264c)

Notes: