Making drush docroot smarter.

index.md

@@ -2,6 +2,22 @@
 
 Welcome to the BLT documentation site! Please read through the [Quick Start Guide](https://github.com/acquia/blt/INSTALL.md) to get started, and then browse the rest of this project's documentation in the sidebar.
 
+# Documentation by role
+
+* Developer
+    * [Onboarding](readme/onboarding.md): “how do I get up and running on project work?”
+    * [Repository architecture](readme/repo-architecture.md): “how is the code organized, and why?”
+    * [Running project tasks](readme/project-tasks.md): “how do I _____ on my local machine?”
+    * [Best practices](readme/best-practices.md): "how should I write code?"
+    * [Workflow](readme/dev-workflow.md): “how do I contribute my code to this project?”
+    * [Automated testing](tests/README.md): “how do I write / run them, and why should I care?”
+* Technical Architect
+    * [Project Architecture document](readme/architecture.md)
+    * [Deploying to cloud](readme/deploy.md)
+    * [Release process](readme/release-process.md)
+    * [Setting up continuous integration](readme/ci.md)
+    * [Open source contribution](readme/os-contribution.md)
+
 # Contributing to BLT
 
 Please feel free to edit any of the pages in this documentation via the 'Edit on GitHub' link at the top right. If you would like to help improve BLT, please file issues via the GitHub issue queue. See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines and instructions.

mkdocs.yml

@@ -15,7 +15,6 @@ pages:
     - Installation & upgrade:  'INSTALL.md'
     - Local development: 'readme/local-development.md'
   - Project documentation:
-    - Overview: 'template/README.md'
     - Developer:
           - Onboarding: 'readme/onboarding.md'
           - Repository architecture: 'readme/repo-architecture.md'

phing/tasks/blt.xml

@@ -87,11 +87,6 @@
     </if>
   </target>
 
-  <target name="echo-property">
-    <echo>${property.name}</echo>
-    <echo level="warning">${${property.name}}</echo>
-  </target>
-
   <!-- This target is meant to test BLT itself on TravisCI.
        A few things to note:
        - We do not run validate:* targets, since they can be run in parallel.

phing/tasks/properties.xml

@@ -26,6 +26,23 @@
   <echo>Executing commands against multisite "${multisite.name}"</echo>
 
   <!-- Default drush alias. -->
-  <property name="drush.default_alias" value="self" override="false" logoutput="false"/>
   <property name="drush.alias" value="${drush.default_alias}" override="false" logoutput="false"/>
+  <!--If alias is not self, then we do not specify the drush root. The drush alias itself should define this in its docroot key.-->
+  <if>
+    <not><equals arg1="${drush.alias}" arg2="self"/></not>
+    <then>
+      <property name="drush.root" value=""/>
+    </then>
+  </if>
+
+  <target name="echo-property" description="Echoes the value of a Phing property.">
+    <echo>${property.name}</echo>
+    <if>
+      <isset property="${property.name}"/>
+      <then>
+        <echo level="warning">${${property.name}}</echo>
+      </then>
+    </if>
+  </target>
+
 </project>

template/drush.wrapper

@@ -37,4 +37,15 @@ if [ ! -f ${DIR}/vendor/bin/drush ]; then
   composer install
 fi
 
-vendor/bin/drush.launcher --alias-path=${DIR}/drush/site-aliases "$@" -r ${DIR}/docroot
+if [ ! -f ${DIR}/vendor/bin/blt ]; then
+  echo "BLT was not found in this project's vendor/bin directory."
+  echo "Attempting to run composer install. This takes a few minutes."
+  composer install
+fi
+
+DOCROOT=$(${DIR}/vendor/bin/blt echo-property -Dproperty.name=drush.root -S -e)
+if [ -z "$DOCROOT" ]; then
+  vendor/bin/drush.launcher --alias-path=${DIR}/drush/site-aliases "$@"
+else
+  vendor/bin/drush.launcher --alias-path=${DIR}/drush/site-aliases "$@" -r ${DIR}/docroot
+fi