From 77a8549b90f009f2f978ec9eeb7aa40757e38eae Mon Sep 17 00:00:00 2001 From: Matthew Grasmick Date: Tue, 9 Aug 2016 14:51:38 -0400 Subject: [PATCH] Removing docs from template. --- INSTALL.md | 10 +++++----- README.md | 4 ++-- {template/readme => docs}/acsf-setup.md | 0 {template/readme => docs}/architecture.md | 0 {template/readme => docs}/best-practices.md | 0 {template/readme => docs}/ci.md | 0 {template/readme => docs}/code-review.md | 0 {template/readme => docs}/deploy.md | 0 {template/readme => docs}/dev-workflow.md | 0 {template/readme => docs}/examples/readme.md | 0 {template/readme => docs}/extending-blt.md | 0 {template/readme => docs}/features-workflow.md | 0 {template/readme => docs}/local-development.md | 0 {template/readme => docs}/onboarding.md | 0 {template/readme => docs}/os-contribution.md | 0 {template/readme => docs}/project-tasks.md | 0 {template/readme => docs}/release-process.md | 0 {template/readme => docs}/repo-architecture.md | 0 {template/readme => docs}/views.md | 0 index.md | 10 +--------- phing/tasks/blt.xml | 1 + scripts/blt/convert-to-composer.sh | 14 ++++++++++++++ template/README.md | 16 ---------------- 23 files changed, 23 insertions(+), 32 deletions(-) rename {template/readme => docs}/acsf-setup.md (100%) rename {template/readme => docs}/architecture.md (100%) rename {template/readme => docs}/best-practices.md (100%) rename {template/readme => docs}/ci.md (100%) rename {template/readme => docs}/code-review.md (100%) rename {template/readme => docs}/deploy.md (100%) rename {template/readme => docs}/dev-workflow.md (100%) rename {template/readme => docs}/examples/readme.md (100%) rename {template/readme => docs}/extending-blt.md (100%) rename {template/readme => docs}/features-workflow.md (100%) rename {template/readme => docs}/local-development.md (100%) rename {template/readme => docs}/onboarding.md (100%) rename {template/readme => docs}/os-contribution.md (100%) rename {template/readme => docs}/project-tasks.md (100%) rename {template/readme => docs}/release-process.md (100%) rename {template/readme => docs}/repo-architecture.md (100%) rename {template/readme => docs}/views.md (100%) diff --git a/INSTALL.md b/INSTALL.md index 4a90427b42..43c90271d3 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -107,11 +107,11 @@ Note that all of the steps from this point forward are the same steps that would Before building your project dependencies and installing Drupal, you must have a fully functional \*AMP stack on your local machine. BLT intentionally does not provide this local development environment--that is outside of the scope of BLT’s intended responsibilities. It does, however, make recommendations for which tools you should use to manage your stack. -Please see [Local Development](template/readme/local-development.md) for more information on setting up your \*AMP stack: +Please see [Local Development](docs/local-development.md) for more information on setting up your \*AMP stack: -* [Acquia Dev Desktop](template/readme/local-development.md#using-acquia-dev-desktop-for-blt-generated-projects) -* [Drupal VM](template/readme/local-development.md#using-drupal-vm-for-blt-generated-projects) -* [Other](https://github.com/acquia/blt/blob/8.x/template/readme/local-development.md#alternative-local-development-environments) +* [Acquia Dev Desktop](docs/local-development.md#using-acquia-dev-desktop-for-blt-generated-projects) +* [Drupal VM](docs/local-development.md#using-drupal-vm-for-blt-generated-projects) +* [Other](https://github.com/acquia/blt/blob/8.x/docs/local-development.md#alternative-local-development-environments) When you have completed setting up your local \*AMP stack, double check that the following pieces of information are still correct: @@ -133,4 +133,4 @@ Note that all common project tasks are executed through `blt`. For a full list o ## Next Steps -Now that your new project works locally, read through the new [README.md](https://github.com/acquia/blt/blob/8.x/template/README.md) file in your project to learn how to perform common project tasks and integrate with third party tools. \ No newline at end of file +Now that your new project works locally, read through the new [README.md](https://github.com/acquia/blt/blob/8.x/template/README.md) file in your project to learn how to perform common project tasks and integrate with third party tools. diff --git a/README.md b/README.md index 5998ffa273..996440e28c 100644 --- a/README.md +++ b/README.md @@ -43,12 +43,12 @@ It scope is discretely defined. It is *not* intended to provide: * [Testing Framework](template/tests). * Behat: default `local.yml` configuration, example tests, `FeatureContext.php` * PHPUnit: default tests for ensuring proper functioning of BLT provided components -* [Project tasks](template/readme/project-tasks.md) +* [Project tasks](docs/project-tasks.md) * Executing tests and validating code * Building dependencies * (Re)installation of Drupal * Production-safe artifact generation and deployment -* [Continuous Integration](template/readme/ci.md) +* [Continuous Integration](docs/ci.md) * Travis CI * GitHub diff --git a/template/readme/acsf-setup.md b/docs/acsf-setup.md similarity index 100% rename from template/readme/acsf-setup.md rename to docs/acsf-setup.md diff --git a/template/readme/architecture.md b/docs/architecture.md similarity index 100% rename from template/readme/architecture.md rename to docs/architecture.md diff --git a/template/readme/best-practices.md b/docs/best-practices.md similarity index 100% rename from template/readme/best-practices.md rename to docs/best-practices.md diff --git a/template/readme/ci.md b/docs/ci.md similarity index 100% rename from template/readme/ci.md rename to docs/ci.md diff --git a/template/readme/code-review.md b/docs/code-review.md similarity index 100% rename from template/readme/code-review.md rename to docs/code-review.md diff --git a/template/readme/deploy.md b/docs/deploy.md similarity index 100% rename from template/readme/deploy.md rename to docs/deploy.md diff --git a/template/readme/dev-workflow.md b/docs/dev-workflow.md similarity index 100% rename from template/readme/dev-workflow.md rename to docs/dev-workflow.md diff --git a/template/readme/examples/readme.md b/docs/examples/readme.md similarity index 100% rename from template/readme/examples/readme.md rename to docs/examples/readme.md diff --git a/template/readme/extending-blt.md b/docs/extending-blt.md similarity index 100% rename from template/readme/extending-blt.md rename to docs/extending-blt.md diff --git a/template/readme/features-workflow.md b/docs/features-workflow.md similarity index 100% rename from template/readme/features-workflow.md rename to docs/features-workflow.md diff --git a/template/readme/local-development.md b/docs/local-development.md similarity index 100% rename from template/readme/local-development.md rename to docs/local-development.md diff --git a/template/readme/onboarding.md b/docs/onboarding.md similarity index 100% rename from template/readme/onboarding.md rename to docs/onboarding.md diff --git a/template/readme/os-contribution.md b/docs/os-contribution.md similarity index 100% rename from template/readme/os-contribution.md rename to docs/os-contribution.md diff --git a/template/readme/project-tasks.md b/docs/project-tasks.md similarity index 100% rename from template/readme/project-tasks.md rename to docs/project-tasks.md diff --git a/template/readme/release-process.md b/docs/release-process.md similarity index 100% rename from template/readme/release-process.md rename to docs/release-process.md diff --git a/template/readme/repo-architecture.md b/docs/repo-architecture.md similarity index 100% rename from template/readme/repo-architecture.md rename to docs/repo-architecture.md diff --git a/template/readme/views.md b/docs/views.md similarity index 100% rename from template/readme/views.md rename to docs/views.md diff --git a/index.md b/index.md index f27ab92fd9..53d71db337 100644 --- a/index.md +++ b/index.md @@ -1,15 +1,7 @@ [Acquia BLT (Build and Launch Tool)](https://github.com/acquia/blt) generates new Drupal projects using a standardized template derived from Acquia Professional Services' best practices. 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 structure - -BLT Documentation is broken into the following top-level segments: - -* Overview - Information about BLT -* Getting started - How to add BLT to your project -* Project documentation - Templated documentation that will be added to your BLTed project. # 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. diff --git a/phing/tasks/blt.xml b/phing/tasks/blt.xml index a358405507..6d2e90e297 100644 --- a/phing/tasks/blt.xml +++ b/phing/tasks/blt.xml @@ -22,6 +22,7 @@ + diff --git a/scripts/blt/convert-to-composer.sh b/scripts/blt/convert-to-composer.sh index c11b6918a2..cea10ac386 100755 --- a/scripts/blt/convert-to-composer.sh +++ b/scripts/blt/convert-to-composer.sh @@ -48,6 +48,20 @@ if [[ $REPLY =~ ^[Yy]$ ]]; then echo "Removing deprecated BLT files from project." rm -rf build blt.sh tests/phpunit/blt + # Removing old docs. + rm acsf-setup.md + rm architecture.md + rm best-practices.md + rm deploy.md + rm dev-workflow.md + rm features-workflow.md + rm local-development.md + rm onboarding.md + rm project-tasks.md + rm release-process.md + rm repo-architecture.md + rm views.md + # Install (new) alias echo "Installing blt alias" yes | ./vendor/acquia/blt/blt.sh install-alias diff --git a/template/README.md b/template/README.md index 289aeb67c7..4acfe2cec4 100644 --- a/template/README.md +++ b/template/README.md @@ -2,22 +2,6 @@ Replace this with a brief description of the ${project.human_name} project. -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) - ## Resources * JIRA - link me!