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/
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.
-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.
+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.
+ +Nearly everything has been redesigned and rebuilt to start from your handheld devices and scale up.
+ +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.
+ +Everything in Bootstrap gets `box-sizing: border-box`, making for easier sizing options and an enhanced grid system.
+ +With four tiers of grid classes—phones, tablets, desktops, and large desktops—you can do some super crazy awesome layouts.
+ +All events are now namespaced, no conflict stuff works way better, and more.
+ +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.
+It's now always responsive and comes with some super handy and re-arrangable subcomponents.
+ +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.
+ +New to the mix are panels and list groups.
+ +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.)
+ +Buttons, tables, forms, alerts, and more have been updated to have more consistent classes for easier customizer and extensibility.
+ +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.
+ +For Internet Explorer 8, you'll need to include Respond.js for all the media queries to work correctly.
+Reference table for classes that have changed between v2.x and v3.0.
.brand |
.navbar-brand |
+ ||||||||||||||||||||||||||||||||||||||||||
.nav-collapse |
+ .navbar-collapse |
+ ||||||||||||||||||||||||||||||||||||||||||
.nav-toggle |
+ .navbar-toggle |
+ ||||||||||||||||||||||||||||||||||||||||||
.btn-navbar |
+ .navbar-btn |
+ ||||||||||||||||||||||||||||||||||||||||||
.hero-unit |
.jumbotron |
@@ -414,25 +476,25 @@ bootstrap/
.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 |
@@ -442,7 +504,7 @@ bootstrap/
-
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 groups | @@ -505,10 +567,6 @@ bootstrap/Form controls | .form-control .form-group |
|||||||||||||||||||||||||||||||
Inline controls | -.checkbox-inline .radio-inline |
- ||||||||||||||||||||||||||||||||
Button group sizes | .btn-group-xs .btn-group-sm .btn-group-lg |
@@ -558,7 +616,7 @@ bootstrap/
-
Hero Unit | -.hero-unit |
- .jumbotron |
- |||
Form actions | .form-actions |
- | |||
Grid | -.span* |
- .col-md-* |
+ Search form | +.form-search |
+ - |
Fluid container | @@ -595,31 +648,11 @@ bootstrap/.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 |
@@ -635,7 +668,7 @@ bootstrap/
-