More release post notes

Author: danielbachhuber

_posts/2016-11-29-version-1.0.0.md

@@ -6,6 +6,34 @@ title: Version 1.0.0 released
 
 Woohoo!
 
+*What does v1.0.0 mean?*
+
+
+### Introducing `WP_CLI::runcommand()`
+
+`WP_CLI::runcommand()` is the best way to run WP-CLI commands from within your WP-CLI command.
+
+### Breaking changes: Uses return code 1 when batch operation partially fails.
+
+Some commands support performing the same operation against multiple resources (e.g. updating two or more plugins wit `wp plugin update akismet hello`). Previously, if one of the operations failed (e.g. a plugin update failed to be downloaded), WP-CLI would display a warning, continue on, and exit with return code 0. Beginning in v1.0.0, WP-CLI uses return code 1 when one or more operations fails.
+
+Affected commands include:
+
+* `wp media (regenerate|import)`
+* `wp menu delete`
+* `wp menu item delete`
+* `wp plugin (install|activate|update|toggle|deactivate|uninstall|delete)`
+* `wp super-admin add`
+* `wp theme (install|update)`
+* `wp term delete`
+* `wp widget (delete|deactivate|reset)`
+
+Use `WP_CLI\Utils\report_batch_operation_results()` in your custom WP-CLI commands to more easily support this behavior.
+
+Relevant pull requests include: [#3584](https://github.com/wp-cli/wp-cli/pull/3584), [#3583](https://github.com/wp-cli/wp-cli/pull/3583), [#3582](https://github.com/wp-cli/wp-cli/pull/3582), [#3585](https://github.com/wp-cli/wp-cli/pull/3585), [#3586](https://github.com/wp-cli/wp-cli/pull/3586), [#3588](https://github.com/wp-cli/wp-cli/pull/3588)
+
+### Everything else in 1.0.0
+
 New commands:
 
 * `wp package update` - Update all installed WP-CLI packages to their latest version.