buildscripts: comments

apps/build.gradle

@@ -1,11 +1,11 @@
-// Gradle script to build the MonkeyWrench/apps sub-project
+// Gradle script to build the "apps" subproject of MonkeyWrench
 
 // Note: "common.gradle" in the root project contains additional initialization
 //   for this project. This initialization is applied in the "build.gradle"
 //   of the root project.
 
 plugins {
-    id 'application' // to build Java applications
+    id 'application' // to build JVM applications
 }
 
 // Register tasks to run specific applications:

common.gradle

@@ -1,7 +1,7 @@
 // Gradle settings and tasks common to all MonkeyWrench subprojects
 
-apply plugin: 'checkstyle'
-apply plugin: 'java'
+apply plugin: 'checkstyle' // to analyze Java sourcecode for style violations
+apply plugin: 'java'       // to compile and test Java projects
 
 java {
     sourceCompatibility = JavaVersion.VERSION_1_8

lib/build.gradle

@@ -1,13 +1,13 @@
-// Gradle script to build the MonkeyWrench/lib sub-project
+// Gradle script to build the "lib" subproject of MonkeyWrench
 
 // Note: "common.gradle" in the root project contains additional initialization
 //   for this project. This initialization is applied in the "build.gradle"
 //   of the root project.
 
 plugins {
-    id 'java-library'
-    id 'maven-publish'
-    id 'signing'
+    id 'java-library'  // to build JVM libraries
+    id 'maven-publish' // to publish artifacts to Maven repositories
+    id 'signing'       // to sign artifacts for publication
 }
 
 ext {

settings.gradle

@@ -1,6 +1,4 @@
-/*
- * settings.gradle: global settings shared by all MonkeyWrench subprojects
- */
+// global settings shared by all MonkeyWrench subprojects
 
 dependencyResolutionManagement {
     repositories {