Skip to content

Commit

Permalink
Finalize draft for D8 Landing Page MVP
Browse files Browse the repository at this point in the history
- Delete remnants of **Running Drupal 8 on Pantheon** (Comments added to issues #933 and #921 to preserve existing content. All other content is beta related and does not need to be retained.

- Delete drupal/8/foo-bar.md example

- Draft intro paragrah for D8 dir, includes inline CTA for contributions.

- Add contribute to docs CTA button

- 2 new sections, **All Articles Exclusive to Drupal 8** and **All Articles Mentioning Drupal 8**
  • Loading branch information
Rachel committed Oct 1, 2015
1 parent a58c6ad commit 7d534e8
Show file tree
Hide file tree
Showing 2 changed files with 24 additions and 77 deletions.
70 changes: 24 additions & 46 deletions source/docs/articles/drupal/8.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,50 +6,28 @@ title: Drupal 8 on Pantheon

<div class="container article">
<div class="col-md-9">
<h1>Drupal 8 Docs</h1>
{% for article in data.8 %}
<article>
<h3><a href="{{ article.url }}">{{ article.title }}</a></h3>
<p> {{ article.description }} </p>
</article>
{% endfor %}
<hr>
<h2> Install Drupal 8 </h2>
<p>Install Drupal 8 as a one-click installation through our <a href="https://dashboard.pantheon.io/products/drupal8/spinup">Drupal 8 Installation Page</a>. After the installation, you will have a Drupal 8 site on Pantheon that will show up in your Dashboard and can be used with the <a href="https://pantheon.io/docs/articles/sites/code/using-the-pantheon-workflow/">Pantheon development workflow</a>.</p>

<h2>Updating Drupal 8 on Pantheon</h2>

Pantheon provides core updates to Drupal 8 using our Dashboard <a href="https://pantheon.io/docs/articles/sites/code/applying-upstream-updates/">upstream update process</a>. Please do not attempt to update Drupal 8 yourself, but instead wait for our Dashboard to give you the option to update Drupal 8 core with a single click:
<img src="/source/docs/assets/images/drupal8-updates.png" alt="Drupal 8 Installation Page">
<br>
If you have done no modification to Drupal 8 core, this process will work automatically. However, if you have made modifications (including applying patches from Drupal.org) you may run into conflicts. A good best practice is to remove any patches you have applied to Drupal 8 prior to updating and then reapply them after updating if they are still needed.


<h2>Troubleshooting Problems with Drupal 8 on Pantheon</h2>

If you run into any problems with your Drupal 8 site, follow these steps:

1. Search the existing [Drupal issue queue](https://www.drupal.org/project/issues/drupal) for existing issues related to your problem. Pay special attention to the beta version to which issues correspond, as well as its current status to help narrow down your problem.
2. Search the existing [Pantheon Drupal 8 issue queue](https://github.com/pantheon-systems/drops-8/issues) for known issues running Drupal 8 on Pantheon. These are issues that only happen on Pantheon, but are not issues in other contexts (local development, simplytest.me, other hosting providers).
3. Attempt to debug the issue yourself using your own developer smarts and information you learned by searching the issue queues and other information sources (Google, Stack Overflow, etc).
4. Report your issue to the appropriate queue depending on if the problem is related to Drupal 8 generally ([Drupal issue queue](https://www.drupal.org/project/issues/drupal)) or is specific to Pantheon ([Pantheon issue queue](https://github.com/pantheon-systems/drops-8/issues)).
5. Monitor the issue you filed, test any available patches, and provide feedback as appropriate.

<h2>Using Drush with Drupal 8 on Pantheon</h2>

Pantheon currently supports using Drush with Drupal 8 on Pantheon. In order to use Drush, you need to use Drush 7.x which can be [installed with Composer by following these instructions](http://docs.drush.org/en/master/install/). Afterwards, you can connect to your sites using the standard process of [using Drush on Pantheon](https://pantheon.io/docs/articles/local/drupal-drush-command-line-utility/). Take note that many Drush commands have changed in Drupal 8 and you should consult the [latest Drush 7 documentation](http://drushcommands.com/drush-7x) for more information.

<h2> Using Drupal 8 Configuration Management on Pantheon</h2>

Pantheon supports the [Drupal 8 Configuration Management system](https://www.drupal.org/documentation/administer/config) and defaults configuration into the `sites/default/config` directory for each Pantheon Drupal 8 site. You can export your configuration into that directory directly using Drush's config-export command or indirectly using Drupal's UI to download the configuration and then use SFTP/Git to place the configuration in `sites/default/config`. For more information on how this all works, check out Matt Cheney and David Strauss' presentation on [Drupal 8 CMI on Managed Workflow at Drupalcon Amsterdam](https://amsterdam2014.drupal.org/session/drupal-8-cmi-managed-workflow).


## See Also

- [Creating a services.yml File for Drupal 8](/docs/articles/drupal/8/create-services-yml-file)
</div>
<div class="col-md-3">
{% include ("sidebarnav.html") %}
</div>

<h1>Drupal 8 on Pantheon</h1>
<p>The Drupal 8 framework is officially supported on Pantheon! Here you'll find all Pantheon related documentation for Drupal 8. As a reminder, our docs are open sourced and we're always excited to see contributions of any kind. If you notice any gaps in documentation, please open an issue to<a href="https://github.com/pantheon-systems/documentation/issues/new?title=New%20Doc%20Proposal%20&body=%23%23%20Title%0A%0A%0A%23%23%20Description%0A%0A%0A%23%23%20Outline%0A%0A%0A%23%23%20Expected%20Audience%0A%0A%0A%23%23%20Path%0A(e.g.%20%60source%2Fdocs%2Farticles%2Fsites%2Fcode%60%20or%20%60source%2Fdocs%2Farticles%2Fwordpress%60)&labels=type%3A%20new%20article"> suggest a new article</a>.</p>
<!-- Contrib dropdown button CTA Contribute to Docs -->
<div class="dropdown" id="contrib-cta-btn">
<button class="btn-secondary dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-expanded="true"><span class="icon-github"></span> Contribute to Docs<span class="caret"></span></button>
<div class="dropdown-menu edit" aria-labelledby="dropdownMenu1">
<a href="https://github.com/pantheon-systems/documentation/edit/master/source{{ page.url }}.md" target="blank"><span class="glyphicon glyphicon-pencil"></span> Edit This Doc</a><br>
<a href="https://github.com/pantheon-systems/documentation/issues/new?title={{page.title}}%20Doc%20Update%20&body=Re%3A%20%5B{{page.title}}%5D(https%3A%2F%2Fpantheon.io{{page.url}})%0A%23%23%20Issue%20Description%3A%0A%0A%23%23%20Suggested%20Resolution%20&labels=type%3A%20doc%20update" target="blank"><span class="glyphicon glyphicon-tag"></span> Report Doc Issue</a><br>
<a href="https://github.com/pantheon-systems/documentation/issues/new?title=New%20Doc%20Proposal%20&body=%23%23%20Title%0A%0A%0A%23%23%20Description%0A%0A%0A%23%23%20Outline%0A%0A%0A%23%23%20Expected%20Audience%0A%0A%0A%23%23%20Path%0A(e.g.%20%60source%2Fdocs%2Farticles%2Fsites%2Fcode%60%20or%20%60source%2Fdocs%2Farticles%2Fwordpress%60)&labels=type%3A%20new%20article" target="blank"><span class="glyphicon glyphicon-file"></span> Suggest New Doc</a>
</div>
</div>
<h2>All Articles Exclusive to Drupal 8</h2>
{% for article in data.8 %}
<article>
<hr>
<h3><a href="{{ article.url }}">{{ article.title }}</a></h3>
<p> {{ article.description }} </p>
</article>
{% endfor %}
<hr>
<h2>All Articles Mentioning Drupal 8</h2>
<h3><a href="/docs/articles/drupal/launch-check-drupal-performance-and-configuration-analysis#frequently-asked-questions">Launch Check - Drupal Performance and Configuration Analysis</a></h3>
<p>Detailed information on Launch Check, Drupal Performance and Configuration Analysis.</p>
</div>
</div>
31 changes: 0 additions & 31 deletions source/docs/articles/drupal/8/foo-bar.md

This file was deleted.

0 comments on commit 7d534e8

Please sign in to comment.