Deprecate KnowsTask (#1957)

* Initial plan

* Deprecate KnowsTask with @deprecated annotation and warning log

Co-authored-by: Goooler <10363352+Goooler@users.noreply.github.com>

* Update src/docs/changes/README.md

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Goooler <10363352+Goooler@users.noreply.github.com>
Co-authored-by: Zongle Wang <wangzongler@gmail.com>

Author: Copilot

src/docs/changes/README.md

@@ -3,6 +3,10 @@
 
 ## [Unreleased]
 
+**Deprecated**
+
+- Deprecate `KnowsTask`, it will be removed in the next major release. ([#1957](https://github.com/GradleUp/shadow/pull/1957))
+
 **Fixed**
 
 - Fix compatibility with Isolated Projects. ([#1947](https://github.com/GradleUp/shadow/pull/1947))

src/main/groovy/com/github/jengelman/gradle/plugins/shadow/tasks/KnowsTask.groovy

@@ -4,13 +4,18 @@ import org.codehaus.groovy.reflection.ReflectionUtils
 import org.gradle.api.DefaultTask
 import org.gradle.api.tasks.TaskAction
 
+/**
+ * @deprecated This task will be removed in the next major release.
+ */
+@Deprecated
 class KnowsTask extends DefaultTask {
 
     public static final String NAME = "knows"
     public static final String DESC = "Do you know who knows?"
 
     @TaskAction
     def knows() {
+        logger.warn("The '{}' task has been deprecated and will be removed in the next major release.", NAME)
         println "\nNo, The Shadow Knows...."
         println ReflectionUtils.getCallingClass(0).getResourceAsStream("/shadowBanner.txt").text
     }