diff --git a/.asf.yaml b/.asf.yaml
index aaa6e8f41dbeb..a3522af9efd0f 100644
--- a/.asf.yaml
+++ b/.asf.yaml
@@ -15,6 +15,11 @@
 # specific language governing permissions and limitations
 # under the License.
 
+# This file controls the settings of this repository
+#
+# See more details at
+# https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features
+
 notifications:
   commits:      commits@arrow.apache.org
   issues:       github@arrow.apache.org
@@ -36,10 +41,12 @@ github:
   enabled_merge_buttons:
     squash: true
     merge: false
-    rebase: false    
+    rebase: false
   features:
-    issues: true        
+    issues: true
 
+# publishes the content of the `asf-site` branch to
+# https://arrow.apache.org/datafusion/
 publish:
   whoami: asf-site
   subdir: datafusion