BS3.0.1 ship list

[mdo]

This issue will eventually turn into the 3.0.1 release notes. Until then it serves as an index of the key changes coming in our first patch release for v3.

Please, no comments here.

Docs

• Three column layouts in examples display like lists in safari. #9880: Use medium grid classes on jumbotron example
• Document the .show & .hide classes #9887: Document .show and .hide classes
• Customize: return in input field produces zip download #9908: Add type="submit" to Customizer compile button to prevent accidental submissions
• missing breakpoint at 480px? #9915: Fix inaccurate comment in media query docs
• Dead link on the main GitHub page #9917: Updated broken download link in README
• Wrong char encoding on some CSS in the examples #9924: Removed non-ASCII character from non-responsive example CSS
• Navigation Menu IE10-9-8 Carousel Example v3.0 vs 2.3.2 #9928, Nav pushes down Carousel in mobile-sized window #9932: Update carousel example to work in IE10 and correctly display navbar in narrow viewports
• Add role="toolbar" to elements with .btn-toolbar. #9931: Add ARIA role="toolbar" to elements with .btn-toolbar in docs examples
• Document class .in is required in addition to .fade for tabs #9991: Better docs for tabbable tab markup and it's fade option
• Update Grunt instruction links and wording #10011: Update Grunt instruction links and wording
• add David (david-dm.org) badge to monitor currentness of dependencies #10012: Add David to project readme to monitor dependency currentness
• Use NPM version of grunt-html-validation #10034: Use npm-registered recent version of grunt-html-validation instead of its git repo
• add cross-reference to .navbar-left/right in .pull-left/right docs #10040: Better cross referencing of default and navbar pull utilities
• Update Live Examples #10042: Updated JS Fiddle tooltip delegation example linked in docs
• Download 2.3.2 Source zip includes 3.0.0 less/js files #10045: Use v2.3.2 release ZIP instead of master zip for downloads from old docs
• docs: add explanation for adding tooltips to disabled elements #10081: Documents workaround for tooltips+popovers on disabled elements
• Document the .navbar-form class #10082: Documents .navbar-form
• Unclear which version is documented online #10087: Add version number to all docs pages (in the footer)
• Update "Nested headers" accessibility docs #10088: Updates accessibility docs regarding nesting heading elements
• Add role="button" to <a> buttons #10112: More role attributes in the docs, this time on link buttons
• correct enable selector for button usage in docs #10131: Corrects button group selector in JavaScript docs
• Carousel example broken #10136: Broken image link in Carousel example
• javascript.html: add data-ride note #10146: Document data-ride carousel feature
• Fixes #10207: alert-dismissable example requires contextual class #10209: Fixed broken dismissable alert example
• Various #10215: More compressed touch icons, updates Respond.js to v1.3.0 and html5shiv.js to v3.6.2, adds bugs to package.json
• Update index.html (update text from hero unit to jumbotron) #10249: Correct component name of jumbotron component in Jumbotron example
• Documentation. Alignment options for Navs #10272: Removed unused link for nav alignment in Components page
• 2.x -> 3.x nabar migration - dividers #10277: Mention removal of navbar vertical dividers in migration docs
• Update getting-started.html #10278: Change Google Maps compatibility warning to a general box-sizing warning with optional reset
• The documentation for tabs is not accurate #10282: Cross reference tabs and tabs plugin
• Note the change to the progress bar. #10298: Add progress bar to migration docs
• 'Getting started' section: refactoring for succinctness, active voice, and consistency with button and link captions. #10299, Getting started docs: tweaks to the _Basic template_ section #10323: Getting Started wording changes
• Document .active class for btns #10316: Document .active and :active for buttons
• Docs missing notice that tooltip/popover data-api is opt-in only #10324, 10338: Restore opt-in warning for tooltips and popovers
• minor improvements to affix docs #10342: Update affix docs to better communicate plugin behavior
• Document lack of fallbacks for CSS transitions for IE8+9 in Browser Support docs #10344: Update IE8-9 support section with table of specific CSS3 and HTML5 features and their support in Bootstrap
• Download button on Bootstrap homepage points to wrong archive #10372: Homepage now shows two download buttons, one for our assets (CSS, JS, and fonts) and one for the source code (the entire repo)
• 'Disabling responsiveness' section of docs: simplification and focus  #10382: Update Disabling responsiveness docs section for brevity
• Color-code the "Internet Explorer 8 and 9" features table #10411: Color coded IE8-9 browser support table
• make Glyphicons mainstream in Carousel examples #10414: Carousel now uses Glyphicons as default left/right chevron icons (text icons are still supported)
• Either document or deprecate .hidden #10417: Document .hidden in the Helper classes Screen reader content section
• add .nav-list & .nav-header to removals section of migration guide #10419: Add nav lists to migration guide
• Add visibly hidden button text for screen reader users. #10453: Add additional screen reader text to button group dropdown toggles
• Docs - Getting started: refactor 'Customizing Bootstrap' #10459: Update Customization section in Getting started page
• Issues with .table-bordered in a .panel #10492: Account for responsive tables in panels
• @ms-viewport should not be sent on all mobiles, only on Surface #10497, Fixes #10497: Fix Windows 8 and Windows Phone 8 behavior and apply to docs #10584: Fix Windows 8 and Windows Phone 8 behavior in Internet Explorer 10 and applies "bug fix" to docs
• Add docs "Welcome" section #10528: Add new About page to the docs with backstory, core team, community links, and translations
• Hardcoded Tooltip arrow positioning #10573: Un-hardcode tooltip arrow widths and padding for easier customization
• add modal 'remote' option semantics change to migration docs #10591: Add modal remote option semantics change to migration docs
• include a copy of the CC-BY 3.0 License that the docs are under #10693; Include a copy of the docs license as a file in the repo
• Horizontal scrollbar appeared on 100% width layout #10711: Address 100% fluid layouts in grid docs and the required padding
• fix #10767; current .img-thumbnail is equivalent to old .img-polaroid #10768: Fix mention of renamed .img-polaroid class in Migration docs
• move /assets/ to /docs-assets/ ; fixes #10715 #10770: Rename /assets to /docs-assets to reduce confusion between /dist and docs dependencies
• Disable IE Compatibility Mode in docs, examples #10790: Disable IE compatibility mode in all docs pages and examples
• Better documentation and optimized examples for grid classes #10856: Update grid docs to better explain the sizing and interactions when using multiple grid tier classes
• Use CDNs for more example JavaScripts #11013: Use CDNs for jQuery and HTML5 shiv
• 3318a98: Add blog link back to docs homepage
• 8df05b9: Remove links to navbar examples from example navbars in Theme example
• 022e404: Delete smaller touch icons and only include one
• 5d1707a: Remove unused mention of .prettyprint styles from code.less (we no longer use that plugin and the class is undocumented, so we're nuking it)
• 6e06489: Remove unnecessary left and right properties from .modal-dialog since we use margin to center the modal
• 19db69c: Add Linux Firefox to supported browsers list
• 99b3515: update outdated JSFiddle example

Bug fixes and changes

• Open modal is shifting body content to the left #9855: Partial fix for open modal content shifting: removed all margin settings to prevent some of the content shifting. Still needs JS love to detect scrollbars and adjust content accordingly (will address in v3.0.2).
• Bootstrap Theme: Navbar > li > a :hover :active option as gradient #9877: Add improved .active state to navbar nav in theme
• Bootstrap Theme: btn hovers are missing #9879: Add hover state (move gradient up 15px) to theme buttons]
• @component-active-color needed? #9909: Add @component-active-color variable to complement @component-active-bg (and apply it to dropdowns, nav pills, and list group items)
• Bower - Added fonts to "main" files #9964: Add fonts directory to bower.json main files list
• Apply gradient stripe @color parameter #9968: Simplify striped progress bar mixin to remove unused color
• Include padding around HTML 5 'output' tag #9969: Add support for output element by styling it more like our .form-control
• Update justified-nav.css (Removed unnecessary ms-linear-gradient prefix) #9973: Removed unnecessary -ms-linear-gradient prefix
• fix #9941 #9981: Account for hover and focus states on pagination disabled items
• code.less: also set default monospace font for <kbd> and <samp> #9989: Set monospace font-family on <kbd> and <samp> to match browser defaults
• Fixes #9974 #9999: Make .table-hover styling apply to <th> within contextual table rows too
• Fix right/next carousel control positioning #10013: Position carousel left and right controls from the left and right, respectively
• IE8 max-width not 1170 - actual 1200px #10014, box-sizing not working in IE 8 #10406: Update grid to use width on .containers instead of max-width as IE8 doesn't fully support box-sizing: border-box when combined with min/max width/height
• Proposal - Fixed width for glypicons #10022: Add width: 1em; to all empty Glyphicons to prevent loading flicker
• Add -1px margin to button addons #10024: Use negative margin to fix the border between button and input in input groups
• Add missing methods (rotateX/Y, perspective(-origin) and transform-origin) #10025: Add additional transform mixins
• Fix responsive table scrolling on Windows Phone 8. #10057: Autohiding scrollbars in responsive tables for Windows Phone 8
• Add mixin for transition-property #10059: Add .transition-property() mixin
• Added -webkit-overflow-scrolling: touch to responsive tables #10079: Native-style scrolling in responsive tables for iOS
• Generate CSS banner via Gruntfile #10101, bootstrap-theme.css should have a licensing+version header #10541, generate CSS banners via Gruntfile; fixes #10101 #10565: Generate CSS file banners via Gruntfile
• Dropdown item - active and hover state color identical #10111: Use different colors for dropdown link hover and active states
• Carousel scale up classes missing for GLYPHICONS #10115: Default carousel controls and Glyphicon controls should behave the same on small devices and up
• CSS docs state the opposite of what is visible #10126: Update responsive test cases to properly highlight hidden class examples
• there appears to be no @headings-text-color (old @headingsColor) #10153: Restore @headings-color variable
• is it possible to add a .small class together with the small element #10154: Add .small to pair with our heading classes (e.g., h1 and .h1)
• Image Center align issue #10164: Document .center-block() mixin and update CSS to include it as a class
• Navbar inverse search styling. #10169: Remove old @navbar-inverse-search-* variables
• .input-group-addon Needs the color set. #10223: Add @input-color to .input-group-addon to match the form controls
• Fixes 10212 - Make custom max-width on row conform to Bootstrap convention #10227: Use correct max-width on Offcanvas example media query and add overflow-x: hidden to prevent scrollbar on narrow devices
• use direct-child selector more in table styles to better support nested tables #10232: Scope .table styles to immediate thead, tbody, and tfoot elements
• Parameterize @breadcrumb-separator #10245: Add @breadcrumb-separator variable for customizing breadcrumbs
• Customizer @link-color-hover fix #10246: Use correct variable for link hover color in Customizer
• Base the navbar default brand hover color on default brand color #10256: Use @navbar-default-brand-color within the @navbar-default-brand-hover-color variable
• Navbar dropdowns failing in IE<10 when bootstrap-theme.css included #10257: Remove filter on navbars in theme.less so that dropdowns can be triggered in IE<10
• fix #10252 by restricting Android Firefox reset to only .form-control & .btn #10265: Scope background-image reset to Bootstrap buttons and form controls only to avoid Android Firefox bug
• Replace invalid US-ASCII character "\xE2") #10336: Replace non-ASCII dash in LESS source file
• contextual table row styles shouldn't override border-color #10341: Don't change border color on contextual table classes
• no generic contextual link classes #10399: Add hover styles to text emphasis classes
• .progress needs to set line-height to properly align text #10407: Add line-height to progress bar for proper text alignment within
• hardcoded tablet size in typography #10436: Use @screen-sm variable instead of hardcoded pixel value in type.less
• Double border with table-bordered within a panel #10484: Allow for .table-bordered in panels by removing side and bottom margins
• Issue with justified dropdown nav pills  #10516: Use auto positioning for dropdowns in justified nav to fix Firefox rendering
• Bordered and simultaneously responsive table has not 2px header underline when is in responsive mode (under 772px) #10521: Only remove bottom-border from last row of cells in tbody and tfoot within responsive tables
• Validation states not working on radio, checkbox, form-control-static #10522: Enable use of form validation class on .radio, .checkbox, .radio-inline, and .checkbox-inline
• Table background color becomes white when using table-responsive class in alert box #10526: Remove custom background on responsive tables and set it in the docs where it should've been originally
• Remove display: block from address #10560: Remove display: block; from address element since browsers set that to start
• document jQuery version requirement; fixes #10355 #10590: Mention required jQuery version in docs
• Problem displaying all navbar links when viewed on phone #10601: Use overflow-y: auto; for .navbar-collapse instead of visible to better enable scrolling on Android 4.x devices (see issue for more details on support and gotchas)
• bootstrap-theme.css: Button corners look funny in IE9 due to gradient filter #10620: Remove filter on buttons for IE9 in theme.less due to bleed-through with rounded corners (matches behavior and style of Bootstrap 2.x)
• Removed unneeded 'accordion-toggle' class from collapse examples #10641: Remove unused .accordion-toggle class from docs example
• Dropdown in panel header does not inherit its colors #10656: Inherit link and caret colors for textual dropdowns in panel headers
• Why does .caret have a "content" attribute? #10694: Remove unnecessary content property from .caret
• Fixed issue where caret wouldn't inherit "active" li style on nav-pills #10695: Ensure carets in .nav-pills dropdown links inherit active color
• Removed the unnecessary override and the !important from .wrap #10729: Removed the unnecessary override and the !important from .wrap in the sticky footer examples
• Default styling for <q> is removed #10755: Don't remove quotes around q element by default
• Use updated Glyphicons to workaround old Android WebKit bug #10778: Use newly-updated Glyphicons to workaround old Android WebKit bug
• Update html5shiv to v3.7.0. #10763: Update html5shiv to v3.7.0
• Update Gruntfile.js fixing undefined jQuery check #10863: Fix check for presence of jQuery
• remove comma separating the color and the color-stop in -webkit-linear-gradient in the #gradient .vertical mixin. #10893: Remove comma separating the color and the color-stop in -webkit-linear-gradient in #gradient > .vertical mixin
• .form-static-control padding-top in regular form (vertical) #10927: Scope padding-top on .form-control-static to horizontal forms only
• Jumbotron: remove the hard-coded font-size from jumbotron.less and moved... #10949: Use variable for jumbotron font-size instead of hard-coded value
• 16.099999999999998px shows up in bootstrap.css #10959: Round .lead font-size to nearest whole pixel
• move .hidden class #10997: Move .hidden from responsive utilities to utilities (where it belongs, especially on account of deprecated .hide per deprecate .hide; fixes #10446 #10769)
• Restore grid mixins #11050: Restore grid mixins
• btn btn-link when used as dropdown-toggle has css box-shadow when open #11126: Remove box-shadow from .btn-link.dropdown-toggle
• Fixes issue #11122 -- navbar-fixed-bottom border #11127: .navbar-fixed-bottom should have a top border, not a bottom border
• .modal-dialog computed z-index=0 in Chrome #11139: Add position: relative; to .modal-dialog so that the z-index takes effect
• Image links selector confusion #11151: Remove rogue H5BP .ir class from print styles
• Carousel indicators for IE8-9 #11186: Add background-color hacks so that clicking carousel indicators in IE8-9 works as intended
• Fixes #10433: Navbar z-index refactor #11188: Refactor z-index on navbars. Removes the default z-index: 1000; and instead only applies it to static-top, fixed-top, and fixed-bottom. Also fixes up the broken default navbar example's fubared padding.
• Remove left padding on first list of list-inline #11206: Remove padding-left from first list item within .list-inline
• Add .animation() mixin #11244: Adds .animation() mixin to replace .progress-bar's regular CSS animation properties (and drops the -moz, -ms, and -o prefies as they are not needed per http://caniuse.com/#feat=css-animation).
• Chrome for OSX print issue with select tags #11248: Apply background-color: #fff; to selects in print styles to fix Chrome bug
• 291a23a: Audited Customizer variables section and rearranged content

Deprecated

• rename @screen-XX to @screen-XX-min for clarity+unambiguity #9963, Use @screen-sm-min in forms #10567: Deprecate @screen-* classes for @screen-*-min to better match the @screen-*-max variables and provide more context to their actual uses.
• deprecate @screen-{phone,tablet,desktop} vars #10005: Finish removing uses of @screen-{device} variables by deprecating them for @screen-*-min wherever possible.
• Fixes #10076: Document hide text #10100: Deprecate .hide-text mixin for .text-hide. This matches our class-mixin strategy elsewhere (e.g., .clearfix) and ensures the class and mixin use the same name to avoid confusion.
• Fixes #10116: Deprecate container-{device} vars #10125: Deprecate inconsistent container variables for new @container-{screen-size} variables (e.g., use @container-sm instead of @container-tablet)
• deprecate .hide; fixes #10446 #10769: Deprecate .hide for .hidden so we don't duplicate functionality.

For a complete list of changes, see the 3.0.1 milestone.

[mdo]

---

layout: post

title: Bootstrap 3.0.1 released

Today we're shipping v3.0.1, a huge patch release with over 600 commits since v3 was released two months ago. We've outlined the key changes, including documentation updates, bug fixes, and even a few deprecations (our first in the history of the project).

Download Bootstrap 3.0.1 or hit the GitHub repository

Changes

to be listed

Moving to MIT license

We've been looking to move to the MIT license for quite some time, and today's release takes us that much closer. With v3.0.1, Bootstrap is dual-licensed as Apache 2 and MIT. The intent is to solely have MIT be our license in a future version (hopefully v3.1), but we need this transition period to do it right.

To make the change, every contributor to Bootstrap must consent to relicense their changes (since we have no contributor license agreement). We're making excellent progress on that front with the community's help and will address any holdouts as they come up. Suffice to say that with v3.0.1, new contributors to Bootstrap will agree to license their contributions under Apache 2 and MIT.

As a heads up, we've placed notices in the contributing guidelines and our project readme about the pending change and transition period.

It goes without saying that we don't need to do this, but we're withholding Bootstrap from some prominent communities still working within the GPL 2 license (which isn't compatible with Apache 2). Theoretically these communities could change their licenses, but when you step back and objectively look at it, it's way easier for us to change. So, we'll do our best to help out everyone. We hope you understand and stick it out with us as we make the move.

Up next

We're already tracking issues for a v3.0.2 release and it's changes will be along the same lines as today's release—bugs and docs. v3.1.0 will likely ship after that sometime with a few new features. As always, no dates have been set yet for any future release.

---

<3,

@mdo, @fat, and team

[mdo]

Started to stub out a blog post, as a teams up for folks.