From 73f56a90365ff5178ab27becd738f615137c1845 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 18 Aug 2013 22:43:29 -0700 Subject: [PATCH] more migration guide work --- assets/css/docs.css | 10 ++++ getting-started.html | 125 +++++++++++++++++++++++++++---------------- 2 files changed, 89 insertions(+), 46 deletions(-) diff --git a/assets/css/docs.css b/assets/css/docs.css index bbc0b43f2e..ef35d29c2f 100644 --- a/assets/css/docs.css +++ b/assets/css/docs.css @@ -983,6 +983,7 @@ h3[id] { .bs-customizer .toggle { float: right; + margin-top: 85px; /* On account of ghetto navbar fix */ } /* Headings and form contrls */ @@ -1068,3 +1069,12 @@ h3[id] { margin-top: 15px; margin-bottom: 5px; } + +/* Migration overview spacing */ +.bs-migration-overview { + margin-bottom: 30px; +} +.bs-migration-overview h4 { + margin-top: 20px; + margin-bottom: 5px; +} diff --git a/getting-started.html b/getting-started.html index 26cc1e5576..b469cf671c 100644 --- a/getting-started.html +++ b/getting-started.html @@ -324,10 +324,60 @@ bootstrap/

Migrating from 2.x to 3.0

-

We've put together a helpful guide that outlines some of the key changes from Bootstrap 2.x to 3.0.

+

To help folks who are looking to upgrade to v3, we've put together a helpful guide that outlines some of the key changes since 2.x. We've outlined some of the major changes and provided tables that summarize additions, deletions, and changes in classes.

-

Major class changes

-

+

Overview of changes

+

With v3 being a near complete rewrite of all the things, it's important to call out a few of the big themes before diving into the specifics below.

+
+
+

New design and an optional theme!

+

With v3 we've gone flat. Don't call it a trend—it's all about customization, folks. Since we simplified the aesthetics though, we thought it'd help to have an optional theme. To use it, check out the Bootstrap theme example.

+ +

Mobile first and always responsive!

+

Nearly everything has been redesigned and rebuilt to start from your handheld devices and scale up.

+ +

Brand new Customizer!

+

It's been redesigned, is now compiled in the browser instead of Heroku, has better dependency support, and even has built-in error handling. Better yet, we now save your customizations to an anonymous Gist for easy reuse, sharing, and modifications.

+ +

Better box model by default.

+

Everything in Bootstrap gets `box-sizing: border-box`, making for easier sizing options and an enhanced grid system.

+ +

Super-powered grid system.

+

With four tiers of grid classes—phones, tablets, desktops, and large desktops—you can do some super crazy awesome layouts.

+ +

Rewritten JavaScript plugins.

+

All events are now namespaced, no conflict stuff works way better, and more.

+ +

New Glyphicons icon font!

+

While they were gone for awhile, we've since restored the Glyphicons to the main repo. In 2.x they were images, but now they're in font format and we've added 40 new glyphs.

+
+
+

Overhauled navbar.

+

It's now always responsive and comes with some super handy and re-arrangable subcomponents.

+ +

Modals are way more responsive.

+

We've overhauled the modal code to make it way more responsive on mobile devices. They now scroll the entire viewport instead of having a max-height.

+ +

Added some components!

+

New to the mix are panels and list groups.

+ +

Removed some components!

+

We've dropped the accordion (replaced with collapsible panels), submenus, typeahead, and a few more small items. (Worth celebrating as much as adding new ones.)

+ +

More consistent base and sizing classes.

+

Buttons, tables, forms, alerts, and more have been updated to have more consistent classes for easier customizer and extensibility.

+ +

Docs have been blown up, yo.

+

We've added a lot of new documentation, not only for our components, but for browser support (including gotchas and bugs), license FAQs, third party support (and workarounds), accessibility, and more.

+ +

Dropped Internet Explorer 7 and Firefox 3.6 support.

+

For Internet Explorer 8, you'll need to include Respond.js for all the media queries to work correctly.

+
+
+ + +

Major class changes

+

Reference table for classes that have changed between v2.x and v3.0.

@@ -357,6 +407,18 @@ bootstrap/ + + + + + + + + + + + + @@ -414,25 +476,25 @@ bootstrap/ - - + + - + - - - - + + + + @@ -442,7 +504,7 @@ bootstrap/ -

What's new

+

What's new

We've added a few new elements and changed some existing ones. Here's their new or updated classes.

.brand .navbar-brand
.nav-collapse.navbar-collapse
.nav-toggle.navbar-toggle
.btn-navbar.navbar-btn
.hero-unit .jumbotron.input-lg
.input-prepend.input-group.checkbox.inline .radio.inline.checkbox-inline .radio-inline
.input-append.input-prepend .input-append .input-group
.add-on .input-group-addon
.btn-navbar.navbar-btn
.thumbnail .img-thumbnail
ul.unstyled.list-unstyled
ul.inline .list-inline
@@ -455,7 +517,7 @@ bootstrap/ - + @@ -505,10 +567,6 @@ bootstrap/ - - - - @@ -558,7 +616,7 @@ bootstrap/ -

What's removed

+

What's removed

The following elements have been dropped or changed in v3.

Panels.panel .panel-body .panel-title .panel-heading .panel-footer .panel-collapse.panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
List groupsForm controls .form-control .form-group
Inline controls.checkbox-inline .radio-inline
Button group sizes .btn-group-xs .btn-group-sm .btn-group-lg
@@ -570,20 +628,15 @@ bootstrap/ - - - - - - - - + + + @@ -595,31 +648,11 @@ bootstrap/ - - - - - - - - - - - - - - - - - - - - @@ -635,7 +668,7 @@ bootstrap/ -

Additional notes

+

Additional notes

We've made many underlying changes in v3 that are not immediately apparent without closer inspection. Base classes, key styles, and behaviors have been adjusted for flexibility and our mobile first approach.

Hero Unit.hero-unit.jumbotron
Form actions .form-actions -
Grid.span*.col-md-*Search form.form-search-
Fluid container.row-fluid .row (no more fixed grid)
Icons.icon-*.glyphicon-*
Navbar button.btn-navbar.navbar-btn
Navbar inner .navbar-inner -
Thumbnails.thumbnails.col-* and .thumbnail
Input append / prepend.input-append .input-prepend .add-on.input-group
Dropdown submenu .dropdown-submenu