From 8ff9e245689b76e39c21434cd2957ca364dc7740 Mon Sep 17 00:00:00 2001 From: Mike Madison Date: Thu, 6 Sep 2018 08:12:13 -0700 Subject: [PATCH] Fixes #3063 by updating faq and install docs to improve install profile instructions. --- docs/FAQ.md | 11 +++++++++++ docs/creating-new-project.md | 6 +++++- 2 files changed, 16 insertions(+), 1 deletion(-) diff --git a/docs/FAQ.md b/docs/FAQ.md index 7cdd67397..8c41b5cec 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -34,6 +34,8 @@ In seeking help, please keep the following points in mind: * All contributions to BLT will be reviewed for compliance with Drupal Coding Standards and best practices as defined by the project maintainer. +## Common BLT Issues and Solutions + ### BLT Command Failure (generic) **Error Message:** @@ -99,3 +101,12 @@ Errors appearing on TravisCI which are not replicable on local or other environm **Solution** [TravisCI has an internal caching feature](https://docs.travis-ci.com/user/caching) which can help speed up builds. At times, though, this cache results in semi-baffling build failures which cannot be replicated elsewhere. In these instances, the solution is sometimes simply to [clear Travis's cache](https://docs.travis-ci.com/user/caching/#Clearing-Caches). + + +## FAQ + +### Can I change the install profile ? / Do I have to use Acquia Lightning with BLT ? + +You can use any install profile you want from Core, Contrib, or your own custom development. We just default to Lightning. + +See https://blt.readthedocs.io/en/latest/creating-new-project/#creating-a-new-project-with-blt diff --git a/docs/creating-new-project.md b/docs/creating-new-project.md index e5af9838f..3029c2eb3 100644 --- a/docs/creating-new-project.md +++ b/docs/creating-new-project.md @@ -15,7 +15,11 @@ 1. Customize *blt/blt.yml* if desired, such as to choose an install profile. By default, BLT will install sites using the [*lightning*](https://github.com/acquia/lightning) profile. You can change this to any other core, contributed, or custom profile in your codebase. Make sure to download the profile if necessary, e.g., `composer require acquia/headless_lightning:~1.1.0`. - + + To use a profile other than Lightning, enter the name of the profile in blt/blt.yml in the profile:name setting. For example: + profile: + name: minimal + 1. Now it’s time to spin up your LAMP stack. 1. **Recommended**: Run the following command to create a DrupalVM instance: