docs: updates on documentation

Added informational and corporate documentation

Author: ADMSK\AVROGAL1

.github/dco.yml

@@ -0,0 +1,3 @@
+# Disable sign-off chcecking for members of the Gradle GitHub organization
+require:
+  members: false

.github/release-drafter.yml

@@ -0,0 +1,21 @@
+name-template: $NEXT_MINOR_VERSION
+tag-template: v$NEXT_MINOR_VERSION
+
+categories:
+  - title: 🚀 New features and improvements
+    labels:
+      - enhancement
+  - title: 🐛 Bug Fixes
+    labels:
+      - bug
+  - title: 🚦 Internal changes
+    labels:
+      - internal
+
+exclude-labels:
+  - no-changelog
+  - duplicate
+  - invalid
+
+template: |
+  $CHANGES

.github/workflows/ci.yml

@@ -40,6 +40,13 @@ jobs:
       - name: Prepare repository
         run: git fetch --unshallow --tags
 
+      - name: Branch name
+        id: branch_name
+        run: |
+          echo ::set-output name=SOURCE_NAME::${GITHUB_REF#refs/*/}
+          echo ::set-output name=SOURCE_BRANCH::${GITHUB_REF#refs/heads/}
+          echo ::set-output name=SOURCE_TAG::${GITHUB_REF#refs/tags/}
+
       - name: Make checksum executable
         run: chmod +x ./scripts/checksum.sh
 

.github/workflows/enforce-labels.yml

@@ -0,0 +1,13 @@
+name: Enforce PR labels for release drafter
+
+on:
+  pull_request:
+    types: [ labeled, unlabeled, opened, edited, synchronize ]
+jobs:
+  enforce-label:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: yogevbd/[email protected]
+        with:
+          REQUIRED_LABELS_ANY: "bug,enhancement,internal,no-changelog"
+          REQUIRED_LABELS_ANY_DESCRIPTION: "Select at least one label ['bug','enhancement','internal','no-changelog'] for the PR"

buildSrc/src/main/groovy/bintray.gradle

@@ -17,6 +17,7 @@ task javadocsJar(type: Jar, dependsOn: rootProject.dokka) {
 }
 
 artifacts {
+  archives jar
   archives javadocsJar
   archives sourcesJar
 }

buildSrc/src/main/groovy/publication.gradle

@@ -78,7 +78,21 @@ task javadoc(type: Javadoc) {
   options.addStringOption('Xdoclint:all,-html', '-quiet')
 }
 
+task mergedJavadoc(type: Javadoc, description: 'Creates Javadoc from all the projects.') {
+  title = 'All modules'
+  destinationDir = new File(project.buildDir, 'merged-javadoc')
+
+  // Note: The closures below are executed lazily.
+  source {
+    subprojects*.sourceSets*.main*.allSource
+  }
+  classpath.from {
+    subprojects*.configurations*.compile*.copyRecursive({ !(it instanceof ProjectDependency); })*.resolve()
+  }
+}
+
 artifacts {
+  archives jar
   archives sourcesJar
   archives javadocJar
 }

buildSrc/src/main/groovy/subproject.gradle

@@ -35,6 +35,8 @@ def useModules = jvmVersion >= 9 && !project.hasProperty('no-modules')
 compileJava {
   if (useModules) {
     doFirst {
+      options.fork = true
+      //options.forkOptions.executable = "${System.getenv("JAVA_HOME")}/bin/javac"
       options.compilerArgs += [
         '--module-path', classpath.asPath,
       ]
@@ -65,6 +67,9 @@ tasks.withType(Test) {
     // Use JUnit 5 with Jupiter
     useJUnitPlatform()
 
+    // Always run tests, even when nothing changed.
+    dependsOn 'cleanTest'
+
     jvmArgs += ["-XX:MaxPermSize=512m"]
 
     minHeapSize = "256m"
@@ -168,6 +173,15 @@ sourceSets {
   }
 }
 
+task createFolders(description: 'Creates the source folders if they do not exist.') doLast {
+  sourceSets*.allSource*.srcDirs*.each { File srcDir ->
+    if (!srcDir.isDirectory()) {
+      println "Creating source folder: ${srcDir}"
+      srcDir.mkdirs()
+    }
+  }
+}
+
 task functionalTest(type: Test) {
   testClassesDirs = sourceSets.functionalTest.output.classesDirs
   classpath = sourceSets.functionalTest.runtimeClasspath

protobuf/build.gradle

@@ -77,5 +77,8 @@ compileTestJava {
 }
 
 javadoc {
+  options.addStringOption('Xdoclint:all,-missing', '-quiet')
   options.encoding = 'UTF-8'
+  //executable = "${System.getenv("JAVA_HOME")}/bin/javadoc"
+  failOnError true
 }

settings.gradle

@@ -25,6 +25,7 @@ pluginManagement {
 // build scan plugin can only be applied in settings file
 plugins {
   id('com.gradle.enterprise') version '3.5.2'
+  id("com.gradle.enterprise.gradle-enterprise-conventions-plugin").version("0.7.2")
 }
 
 gradleEnterprise {
@@ -37,11 +38,36 @@ gradleEnterprise {
 
 rootProject.name = 'gradle-java-sample'
 
-include 'appflow'
-include 'testflow'
-include 'protobuf'
-include 'flatbuffers'
-include 'avro'
-include 'thrift'
-include 'codecheck'
-include 'db-schema'
+// Find the directories containing a "build.gradle" file in the root directory
+// of the project. That is, every directory containing a "build.gradle" will
+// be automatically the subproject of this project.
+def subDirs = rootDir.listFiles(new FileFilter() {
+  boolean accept(File file) {
+    if (!file.isDirectory()) {
+      return false
+    }
+    if (file.name == 'buildSrc') {
+      return false
+    }
+    return new File(file, 'build.gradle').isFile()
+  }
+})
+
+subDirs.each { File dir ->
+  if (dir.name.startsWith("gradle-")) {
+    include dir.name
+  }
+
+  include 'appflow'
+  include 'testflow'
+  include 'protobuf'
+  include 'flatbuffers'
+  include 'avro'
+  include 'thrift'
+  include 'codecheck'
+  include 'db-schema'
+}
+
+//rootProject.children.forEach {
+//  it.projectDir = rootDir.resolve( "subprojects/${it.name}")
+//}