organizingGradleProjects

Clone Tools
  • last updated a few seconds ago
Constraints
Constraints: committers
 
Constraints: files
Constraints: dates
Fix SamplesOrganizingGradleProjectsIntegrationTest

Update sample of building a Gradle distribution

- Use Providers

- Avoid warnings from new validation checks

- use plugins {}

    • -3
    • +13
    ./customGradleDistribution/build.gradle
    • -0
    • +0
    ./customGradleDistribution/settings.gradle
  1. … 1 more file in changeset.
Fix Kotlin DSL sample in Organizing Gradle Projects

Signed-off-by: Paul Merlin <paul@gradle.com>

Doc updates: deprecations in AbstractArchiveTask

This commit contains the userguide and javadoc updates following the

deprecations in AbstractArchiveTask.

Samples are also updated to no longer use any deprecated API.

Issue #8217

    • -1
    • +1
    ./customGradleDistribution/build.gradle
  1. … 24 more files in changeset.
Revert "Convert groovy samples to lazy tasks API"

This reverts commit 5201a50eb5eb42ad69f327c9f8b073c115653656.

    • -1
    • +1
    ./configureProjectUsingScript/groovy/other.gradle
    • -2
    • +2
    ./customGradleDistribution/build.gradle
  1. … 257 more files in changeset.
Convert `userguide` samples to lazy tasks API

    • -1
    • +1
    ./configureProjectUsingScript/kotlin/other.gradle.kts
  1. … 157 more files in changeset.
Convert groovy samples to lazy tasks API

    • -1
    • +1
    ./configureProjectUsingScript/groovy/other.gradle
    • -2
    • +2
    ./customGradleDistribution/build.gradle
  1. … 262 more files in changeset.
Fix userguide/organizingGradleProjects/separatedTestTypes/kotlin sample

Signed-off-by: Paul Merlin <paul@gradle.com>

Fix path to script plugin :man_facepalming:

Signed-off-by: StefMa <StefMaDev@outlook.com>

Add kotlin DSL samples

Signed-off-by: StefMa <StefMaDev@outlook.com>

    • -1
    • +3
    ./separatedTestTypes/groovy/build.gradle
    • -2
    • +9
    ./separatedTestTypes/integrationTestSourceSetAndTask.sample.conf
    • -0
    • +12
    ./separatedTestTypes/kotlin/build.gradle.kts
    • -0
    • +22
    ./separatedTestTypes/kotlin/gradle/integration-test.gradle.kts
    • -0
    • +1
    ./separatedTestTypes/kotlin/settings.gradle.kts
    • -0
    • +6
    ./separatedTestTypes/kotlin/src/main/java/FileReader.java
    • -0
    • +7
    ./separatedTestTypes/kotlin/src/main/java/StringUtils.java
  1. … 1 more file in changeset.
Move organizing samples to Groovy dir

Signed-off-by: StefMa <StefMaDev@outlook.com>

    • -22
    • +0
    ./separatedTestTypes/gradle/integration-test.gradle
    • -0
    • +10
    ./separatedTestTypes/groovy/build.gradle
    • -0
    • +22
    ./separatedTestTypes/groovy/gradle/integration-test.gradle
    • -0
    • +1
    ./separatedTestTypes/groovy/settings.gradle
    • -0
    • +6
    ./separatedTestTypes/groovy/src/main/java/FileReader.java
    • -0
    • +7
    ./separatedTestTypes/groovy/src/main/java/StringUtils.java
  1. … 1 more file in changeset.
Include Kotlin DSL samples in the plugins doc chapter

See #6424

    • -1
    • +0
    ./configureProjectUsingScript/build.gradle
    • -2
    • +9
    ./configureProjectUsingScript/configureProjectUsingScript.sample.conf
    • -0
    • +1
    ./configureProjectUsingScript/groovy/build.gradle
    • -0
    • +6
    ./configureProjectUsingScript/groovy/other.gradle
    • -0
    • +1
    ./configureProjectUsingScript/groovy/settings.gradle
    • -0
    • +1
    ./configureProjectUsingScript/kotlin/build.gradle.kts
    • -0
    • +6
    ./configureProjectUsingScript/kotlin/other.gradle.kts
    • -0
    • +1
    ./configureProjectUsingScript/kotlin/settings.gradle.kts
    • -6
    • +0
    ./configureProjectUsingScript/other.gradle
    • -1
    • +0
    ./configureProjectUsingScript/settings.gradle
  1. … 102 more files in changeset.
Convert user manual to be generated by Asciidoctor only

This change replaces all embedded Docbook syntax from the user manual.

Asciidoctor files are now converted directly to HTML and PDF.

It not only greatly simplifies the user manual generation pipeline, but also it makes it faster.

I did the following for all user manual pages:

- [x] Adjusted links to other manual pages, DSL docs, and Javadocs where necessary.

Fixed a couple dozen broken links at least.

- [x] Convert samples XML from docbook to asciidoctor syntax

- [x] Converted wide tables to a more flexible list-based display

Important contributor differences from now on:

- Users must use a `<file>.adoc#` prefix for all cross-reference links.

This is _required_ to achieve working links in all 3 outputs: multi-page user manual, single-page user manual, and PDF.

- The manual PDF is no longer themed, and no longer has the list of examples links in the TOC.

- File names were changed from camelCased to snake_case to have a crystal clear 1-1 mapping between source to output.

- Section reference verification is now handled by Asciidoctor verbose mode.

- The single-page user manual has the same navigation as the multi-page manual for now.

- [Common Asciidoctor extensions](https://github.com/gradle/dotorg-docs/tree/master/docs-asciidoctor-extensions) are now used by Gradle Guides and the User Manual, however, the the web assets (CSS, JS, etc) are not yet merged.

These extensions are responsible for injecting the navigation and styles.

The header/footer/navigation HTML can now be found under `subprojects/docs/src/main/resources`.

    • -4
    • +4
    ./separatedTestTypes/gradle/integration-test.gradle
  1. … 401 more files in changeset.
Externalize samples testing infrastructure

This change replaces UserGuideSamplesRunner with an external library

called sample-check. Sample discovery, execution, and normalization

is delegated to this library, with some custom normalizers remaining

in the Gradle codebase.

Samples output has become co-located with the sample code. Samples tests

must be run with Java 8+.

    • -0
    • +2
    ./configureProjectUsingScript/configureProjectUsingScript.sample.conf
    • -0
    • +2
    ./separatedTestTypes/integrationTestSourceSetAndTask.sample.conf
  1. … 781 more files in changeset.
Enhances the existing best practices chapter in user guide (#4987)

    • -0
    • +19
    ./customGradleDistribution/build.gradle
    • -0
    • +7
    ./customGradleDistribution/src/init.d/repositories.gradle
    • -0
    • +10
    ./separatedTestTypes/build.gradle
    • -0
    • +22
    ./separatedTestTypes/gradle/integration-test.gradle
    • -0
    • +1
    ./separatedTestTypes/settings.gradle
    • -0
    • +42
    ./separatedTestTypes/src/integTest/java/DefaultFileReaderIntegrationTest.java
    • -0
    • +10
    ./separatedTestTypes/src/main/java/DefaultFileReader.java
    • -0
    • +6
    ./separatedTestTypes/src/main/java/FileReader.java
    • -0
    • +7
    ./separatedTestTypes/src/main/java/StringUtils.java
    • -0
    • +9
    ./separatedTestTypes/src/test/java/StringUtilsTest.java
  1. … 2 more files in changeset.
Clean up and reorganize existing content of best practices chapter (#4892)

    • -0
    • +1
    ./configureProjectUsingScript/build.gradle
    • -0
    • +6
    ./configureProjectUsingScript/other.gradle
    • -0
    • +1
    ./configureProjectUsingScript/settings.gradle
  1. … 48 more files in changeset.