"Understanding tasks" docs page problems

[acmpo6ou]

Issue type

Wrong or misleading information

Problem description

The Understanding tasks page in the docs has some problems.

The explanation is good, but there are some problems on the page.

The "3. Implementing tasks" section has a link at the end "You can learn more about developing custom task types in Implementing Tasks.", this link just goes to section "3. Implementing tasks". So the "3. Implementing tasks" section is referring to itself, which is super confusing, and I don't know what the intention was there.

The code examples in the "3. Implementing tasks" section are wrong for Kotlin and Groovy. They should be the other way around. The Kotlin example uses "extend" keyword that doesn't exist in Kotlin, and Groovy example uses Kotlin syntax.

Here is what the page has in the Kotlin example:

abstract class MyCopyTask extends DefaultTask {

}

as you can see, this is not even Kotlin code. The Groovy example has the Kotlin code:

abstract class MyCopyTask : DefaultTask() {

}

Context (optional)

No response

Page with the problem

https://docs.gradle.org/current/userguide/more_about_tasks.html#sec:implementing_tasks

[ljacomet]

This is a valid documentation issue.

---

@lkasso We should really move all the snippets in those pages to testable ones, so that such issues with invalid code are not even possible.

[lkasso]

Looks like the Groovy and Kotlin examples are reversed in some pages. I am going through the chapter and fixing them.