[HTML+CSS] Cleaned up front end HTML & CSS. Fixes #95.

[jpsim]

Also addresses #175. This is necessarily a large PR since it touches on the overall front end design and should have been done at the project's inception. But it cuts the number of lines of CSS from 927 to 418 by deduplicating CSS logic and rules that used to override due to the CSS being hacked together from Apple's source and us adding in styling in an ad-hoc fashion.

If you'd like to review these changes, I'd appreciate if you could browse Alamofire's HTML docs from this branch and compare to what's currently generated by the master branch.

Some of these changes may feel like a step backwards design-wise, but it should be much simpler to change things now.

Feedback is very appreciated at this point, so please speak up about what you dislike @segiddins @yoshyosh @beltex @jessesquires.

[orta]

@jpsim https://static.realm.io/alamofire-jp-frontend-cleanup is a 404 ATM, likely permissions

[jpsim]

The links were wrong when I first created the issue. Here are the right links:

• https://static.realm.io/jazzy_demo/alamofire-jp-frontend-cleanup
• https://static.realm.io/jazzy_demo/alamofire-master

[jessesquires]

@jpsim - new design looks great! I think this is a huge improvement. 👏 👏

[orta]

Yes +1
Feels much much nicer, will be very glad to get this on CocoaDocs.

[beltex]

@jpsim Very sharp. Nice work! :)

[segiddins]

Code blocks look weird
https://www.dropbox.com/s/4a1rui5wfeacv4n/Screenshot%202015-04-06%2009.50.16.png?dl=0

[jpsim]

That looks pretty funny. What browser are you using? I can't see that in either Safari or Chrome.

[segiddins]

No visible scrollbar for declarations that overflow
https://www.dropbox.com/s/ey14yh1za872f7m/Screenshot%202015-04-06%2009.53.06.png?dl=0

[segiddins]

That looks pretty funny. What browser are you using? I can't see that in either Safari or Chrome.

Safari -- I think it's leaving room for the scrollbar when there is none?

[segiddins]

The line under the header looks weird: https://www.dropbox.com/s/ixfk1hx883zz7e5/Screenshot%202015-04-06%2009.55.11.png?dl=0

[segiddins]

Too much spacing before encode https://static.realm.io/jazzy_demo/alamofire-jp-frontend-cleanup/Enums/ParameterEncoding.html

[segiddins]

Extra space between init & request: https://static.realm.io/jazzy_demo/alamofire-jp-frontend-cleanup/Classes/Manager.html#/s:vC9Alamofire7Manager24startRequestsImmediatelySb

[segiddins]

technically it's SCSS

[segiddins]

@jpsim this is awesome! See my comments above, but I'm also curious to know that things are still right in Dash?

[jpsim]

Things look fine in Dash to me.

[jpsim]

From Sam's feedback, the biggest stoppers to merging this are:

• vertical spacing in some places
• mis-rendered code blocks ([HTML+CSS] Cleaned up front end HTML & CSS. Fixes #95. #203 (comment))
• the look of the h1/h2 underlines ([HTML+CSS] Cleaned up front end HTML & CSS. Fixes #95. #203 (comment))
• some scss values should be variables

Sam, are you ok to address these?

[segiddins]

@jpsim yup, I can address all of them relatively shortly.

[segiddins]

@jpsim think I cleaned up after my comments?

[jpsim]

Please update the integration specs, then merge away, Sam!