Re: Documentation Workflow
Re: Documentation Workflow
- Subject: Re: Documentation Workflow
- From: Carl Hoefs <email@hidden>
- Date: Thu, 17 Nov 2016 11:15:49 -0800
Fixing the layout of the documentation doesn't help the core problem, namely, the way in which it's organized. Each page is so sparse as to be almost worthless. You have to drill down 2, 3, 4 or more links to find the information that you want, dragging the reader through page after page...
Why not simply have all the relevant information on the page, where it belongs?
-Carl
> On Nov 17, 2016, at 8:38 AM, Alex Zavatone <email@hidden> 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