docs(core): errors will fail deployment, not synthesis (#18342)

Fix inaccurate information in the documentation.

Closes #18317


----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: rix0rrr

packages/@aws-cdk/core/lib/annotations.ts

@@ -44,7 +44,7 @@ export class Annotations {
 
   /**
    * Adds an { "error": <message> } metadata entry to this construct.
-   * The toolkit will fail synthesis when errors are reported.
+   * The toolkit will fail deployment of any stack that has errors reported against it.
    * @param message The error message.
    */
   public addError(message: string) {