Clone
 

peter ledbrook <peter@cacoethes.co.uk> in Gradle

Remove Gradle Wrapper version output from user manual (#9000)

* Remove Gradle Wrapper version output from user manual

It would take far too much effort to ensure that the sample in the Gradle

Wrapper reference chapter that shows the output of running `./gradlew -v`

is consistent with the current version of Gradle. Since it doesn't provide

a lot of value to the reader, I've just removed it.

Clarify text on handling optional dependencies (#8882)

The _Handling optional dependencies_ section of the Maven migration chapter

used rather awkward language to distinguish between optional transitive

dependencies and dependencies that a user wants to declare as optional in a

project's published POM.

I think this is a slight improvement.

Fix Asciidoctor deprecation warnings (#8513)

This meant upgrading to version 1.5.10 of the Asciidoctor Gradle Plugin and

*also* specifying the version of AsciidoctorJ to use in the build because

version 1.5.10 of the plugin uses a version of AsciidoctorJ that is binary

incompatible with our Asciidoctor extension.

    • -1
    • +1
    /buildSrc/subprojects/build/build.gradle.kts
Incorporate feedback into Maven migration guide (#8104)

In particular, these changes mention publishing source and Javadoc JARs, and the

local Maven cache and how it differs from Gradle's.

Fix a sample caption that referred to old filesFor() (#8075)

Fix Kotlin sample to be consistent with Groovy one (#8073)

Remove tutorials from user manual (#7759)

Implements dotorg-docs#126. I had to also remove a few references to the old

tutorial chapters.

Improve Kotlin DSL chapter (#7743)

Attempt to improve the Kotlin DSL chapter

The idea here was to make the chapter clearer and easier to read, while

maintaining accuracy.

Signed-off-by: Peter Ledbrook <peter@gradle.com>

Merge pull request #7760 from gradle/pl/fix-broken-link

Fix links to 5 Things section of user manual

Merge pull request #6870 from pledbrook/java-plugin-chapter

Update diagrams in Java Plugin chapter

Add details of upgrading to Gradle 5.0 (#6761)

* Rename upgrading to Gradle 5.0 chapter

* Add Gradle 5.0 breaking changes to upgrade chapter

This commit groups and lists all the breaking changes that Gradle 5.0

introduces, many of which were earlier documented as deprecations.

* Try different headings in upgrade chapter

Trying out a change from "Changes in 4.x" to "Upgrading from 4.x and earlier".

This is to see whether it's clearer to readers that they must apply all

all sections up to and including the version they're upgrading from.

Create a new chapter on building Java projects (#4800)

Merge the following changes from @pledbrook:

* Create a new chapter on Java projects

This covers a general overview in the Building Java projects chapter and a

fleshed out example in the Java testing chapter of setting up integration tests

in a Java build.

* Prune the Java Plugin chapter

Much of the content was overlapping with the new Building Java & JVM projects

chapter, so it has now been removed. The chapter is now a pure reference.

* Add plugin reference chapter for Base Plugin

  1. … 6 more files in changeset.
Create a new chapter on building Java projects (#4800)

Merge the following changes from @pledbrook:

* Create a new chapter on Java projects

This covers a general overview in the Building Java projects chapter and a

fleshed out example in the Java testing chapter of setting up integration tests

in a Java build.

* Prune the Java Plugin chapter

Much of the content was overlapping with the new Building Java & JVM projects

chapter, so it has now been removed. The chapter is now a pure reference.

* Add plugin reference chapter for Base Plugin

    • -0
    • +92
    /subprojects/docs/src/docs/userguide/basePlugin.adoc
    • -0
    • +469
    /subprojects/docs/src/docs/userguide/buildingJavaProjects.adoc
    • -0
    • +400
    /subprojects/docs/src/docs/userguide/javaTesting.adoc
    • -0
    • +88
    /subprojects/docs/src/samples/userguide/java/basic/build.gradle
  1. … 6 more files in changeset.
Fix typo in files chapter (#4801)

Polish release notes and add preamble

    • -33
    • +61
    /subprojects/docs/src/docs/release/notes.md
Improve user manual section on incremental build. (#688)

* Improve user manual section on incremental build.

This is a rewrite and expansion of the incremental build section of the user

manual. It provides proper coverage of this important topic while introducing

some of the new features in Gradle 3.0.

* Incorporate feedback

* Fix links and typos in user guide

    • -39
    • +682
    /subprojects/docs/src/docs/userguide/tasks.xml
  1. … 23 more files in changeset.
Fix duplicate level 2 section IDs

Add unit test for UserGuideSectionVerifier task

The unit test identified a weakness in the verification, so I have also modified

the XPath pattern so that it catches missing IDs on second level sections as well

as first level.

Make run before all other guide tasks.

Apply suggestions from @bmuschko

Update user guide page titles.

This is mainly to improve Google search results so that user guide pages appear

with the text "Gradle User Guide" rather than "Gradle Release Notes". This

change also makes the titles consistent with the DSL reference.

Improve integration with docs.gradle.org wrt CSS styles.

The styles in userguide.css related to the heading link icons didn't play

nicely with the decorate.css on docs.gradle.org. These changes should make

the docs look nice standalone or published to docs.gradle.org.

    • -2
    • +1
    /subprojects/docs/src/docs/css/userguide.css
Fix duplicate section IDs in user guide.

  1. … 31 more files in changeset.
Generate IDs for user guide sections without them.

  1. … 61 more files in changeset.
Apply small fixes and improvements to release notes.

    • -13
    • +13
    /subprojects/docs/src/docs/release/notes.md
Jazz up composite build support in release notes.

    • -1
    • +1
    /subprojects/docs/src/docs/release/notes.md
Use American spelling in release notes.

    • -4
    • +4
    /subprojects/docs/src/docs/release/notes.md
Refine release notes.

    • -66
    • +88
    /subprojects/docs/src/docs/release/notes.md
Remove unused imports.

Add custom task for verifying section IDs.

This replaces the `doLast` action that was operating on the single page HTML.

The new task checks for both sections without IDs and duplicate IDs.