Re: Documentation Workflow
Re: Documentation Workflow
- Subject: Re: Documentation Workflow
- From: Alex Zavatone <email@hidden>
- Date: Thu, 17 Nov 2016 13:13:12 -0600
Adding this CSS alone increases readability dramatically for the docs pages when viewing from a browser.
@namespace url(http://www.w3.org/1999/xhtml);
*{font-family:"Tahoma", sans-serif !important;}
Whatever Apple's using now looks skinny and is is simply unsettling.
Now, if we could only get rid of all that useless and excessive white space on the pages, you might not need a whole monitor to use for docs display.
Honestly, on the Objective-C page, there's 1/2 an inch of empty space between the the summary text, the horizontal gray line and then another 1/2 inch between the horizontal gray line and the word, "Overview".
That's a wasted inch. And on the page I just opened,
https://developer.apple.com/reference/objectivec?language=objc
…there is PRECISELY 3 inches of empty white space to the left of all the text and on the right of all text.
Whichever art school student Apple hired to set the UI standards for "UX Experience" is simply an idiot.
Sadly, I am so old that I remember when Apple was known for its GOOD UI design and user experience, not this minimalist "let's use up all the user's browser real estate with glaring white space.
This is not a fine art museum where every painting needs to be framed by 5 feet of white space. These are dev docs that have to present the content in an easy to read manner and be RESPECTFUL of the screen real estate. It's also NICE not to use full white as the background for presentation, because it's glaring and there are still people spending all day sitting under flouresent lights in offices staring at their screens. This UI is PAINFUL and causes eye fatigue.
On Nov 17, 2016, at 10:38 AM, Alex Zavatone wrote:
>
> On Nov 17, 2016, at 9:13 AM, Slipp Douglas Thompson wrote:
>
>> No, you don't need to know HTML or CSS to get this to work.
>>
>> Here's a basic step-by-step:
>>
>> 1. Download & install the Stylish plugin/add-on/extension for your browser of choice. The official userstyles.org Stylish is available for Chrome ( https://chrome.google.com/webstore/detail/stylish/fjnbnpbmkenffdnngjfgmeleoegfcffe?hl=en ) and Firefox ( https://addons.mozilla.org/en-us/firefox/addon/stylish/ ), though it looks like someone else made a Safari version ( http://sobolev.us/stylish/ ).
>> 2. Download the 2 files from that gist.
>> 3. Open up the Stylish plugin/add-on/extension's UI and click the import button, choose one file, then click import and choose the other file.
>> 4. Enjoy better layout/styling whenever you visit a URL matching `http[s]://developer.apple.com/reference/*`. ;-)
>> 5 (optional). Stylish for Chrome allows you to toggle styles on & off for the current page by clicking the toolbar icon for the extension (to the right of the address bar; the Stylish extension's icon is an “S” in a 4-colored square), so you can decide on-the-fly if you really want to use these changes or not. I'd imagine Stylish for other browsers works similarly.
>> 6 (optional). Modify the CSS to your liking. The most obvious point of customization would be the `font-size: 10pt !important;` line— you can change the `10pt` to `12pt` or `24pt` or `6pt` or whatever other numerical font size you please.
>>
>
> Oh, man. What a godsend. No more UI that looks like it was a graphic design major's "testing limits" project.
>
>
>
> _______________________________________________
>
> Cocoa-dev mailing list (email@hidden)
>
> Please do not post admin requests or moderator comments to the list.
> Contact the moderators at cocoa-dev-admins(at)lists.apple.com
>
> Help/Unsubscribe/Update your Subscription:
>
> This email sent to email@hidden
_______________________________________________
Cocoa-dev mailing list (email@hidden)
Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden