<chapter id='build_announcements_plugin'>
    <title>The Build Announcements Plugin</title>
    <note>
        <para>
            The build announcements plugin is currently <link linkend="feature_lifecycle">incubating</link>. Please be aware that the DSL and other configuration may change in later Gradle versions.
        </para>
    </note>
    <para>The build announcements plugin uses the <link linkend="announce_plugin">announce</link> plugin to send local announcements on important events in the build.</para>
    <section id="sec:build_announcements_usage">
        <title>Usage</title>
        <para>To use the build announcements plugin, include the following in your build script:</para>
        <sample id="useBuildAnnouncementsPlugin" dir="announce" title="Using the build announcements plugin">
            <sourcefile file="build.gradle" snippet="use-build-announcements-plugin"/>
        </sample>
        <para>That's it. If you want to tweak where the announcements go, you can configure the <link linkend="announce_plugin">announce</link> plugin to
            change the local announcer.
        </para>
        <para>You can also apply the plugin from an init script:</para>
        <sample id="useBuildAnnouncementsPlugin" dir="announce" title="Using the build announcements plugin from an init script">
            <sourcefile file="init.gradle"/>
            <test args="-I init.gradle"/>
        </sample>
    </section>
</chapter>
