Release notes: Sprint 13

This is a draft!

This document will not be finalized until the end of Sprint 13 -- August 30.

What's New in Sprint 13

• Localization
  • French Localization: Brackets detects the user's locale setting automatically. There are a few bugs where minor bits of the UI remain in English despite the locale.
  • Brackets unofficially also supports German in this sprint.
• Install/Upgrade Usability
  • Update Notification: Brackets will automatically notify you when a newer build is released. This won't happen until the end of the following sprint, 2-3 weeks from now.
  • Mac Install Experience: DMG with shortcut: Instead of a ZIP file, the distribution for Mac is now a DMG file containing a shortcut to /Applications for easy drag & drop.
  • Windows Install Experience: EXE installer: Instead of a ZIP file, the distribution for Windows is now a native MSI installer.
  • First Launch Readme/Demo Project
  • Quick access to the extensions folder via Debug > Show Extensions Folder
• Native Shell
  • Brackets has officially migrated to the new CEF3-based native shell! The installer/DMG distributions above package brackets-shell. This gives Brackets a stronger platform to build on, and offers benefits like slightly faster performance and a newer version of the developer tools for debugging Brackets. A few issues remain though.
• Code Hinting
  • Code Completion for HTML Attribute Values: Attributes with enumerated values (such as <link rel> or <input type>) show hints automatically after completing the attribute name. Hints can also be invoked manually with Ctrl+Space.

UI Changes

API Changes

Initialization & HTML structure - The HTML DOM is no longer completly initialized when require.js loads Brackets modules. Brackets extensions are unaffected since they are always loaded after the DOM initialization is complete; this only affects core modules that depend on or modify HTML during load.

• Before touching the DOM, modules should now register a htmlReady event listener on the utils/AppInit module before touching the DOM. E.g. AppInit.htmlReady(function () { /* query main Brackets DOM */ }).
• The brackets.ready event handler has been moved to AppInit.appReady
• A new utils/Global module was added to handle the initialization of the brackets namespace
• Most of the content of index.html has been moved into the Mustache template htmlContent/main-view.html.

Live development - Now uses standard jQuery events, so the code required to add/remove listeners is slightly different and all listeners receive a new first parameter (the event). Event names have also changed. See pull request for details.

New/Improved Extensibility APIs

Command infrastructure - New CommandManager.getAll() API: returns all registered commands. Could be used to build a shortcut key assignment UI, etc.

Localization - Brackets now includes the RequireJS i18n plugin and Mustache.

Known Issues

• Debug > Run Tests is disabled in the installer/DMG distributions of Brackets, because the unit test code is not included. To run unit tests, pull Brackets from GitHub instead.
• Debug > Show Developer Tools now opens in a new tab in Chrome, rather than a new windows in Brackets. This is a temporary(ish) change due to CEF3. But on the upside, CEF3's developer tools include many updated features!
• #1283: Text selection highlight sometimes jiggles when horizontally resizing window.
• #1473: Uninstalling on Windows sometimes does not remove the Start menu shortcut for Brackets.

Community contributions to Brackets

• Localization infrastructure and basic language switcher UI by Jonathan Diehl
• Live development code cleanup by Jonathan Diehl
• Fix #1409: Exception when opening inline editor on blank line by Tom Lieber
• Code cleanup in SVG sprites by Dmitry Baranovskiy

Contributions from Brackets

Bugs fixed in Sprint 13

For details on the bugs addressed, please refer to closed sprint 13 bugs and closed sprint 13 brackets-shell bugs. A few of the fixed bugs might not be caught by this search query, however.