- Issue created by @ressa
- First commit to issue fork.
- Merge request !65Add a task tutorial on using DDEV for a local enviornment. And refactor... β (Merged) created by eojthebrave
- πΊπΈUnited States eojthebrave Minneapolis, MN
I think recommending DDEV in the User Guide is a good idea. We've already got a page on local development environments here https://www.drupal.org/docs/user_guide/en/install-dev-making.html β .
In my update I added a new page with details about using DDEV. Then reordered the pages in the chapter so that the "Preparing to Install" will be first now, and provides a sort of check list for things you'll need to do and decisions you'll need to make. As well as recommending that if you're unsure, or just want to get started quick, you should use DDEV.
Then I also updated the other tutorials in this chapter, and the one in chapter 11 about development environments, with information about using DDEV.
My hope is that this helps people who are unsure, or don't care, about where to start by pointing them to DDEV. While still providing enough generic information for people who are using something else so that they can figure things out.
- π©π°Denmark ressa Copenhagen
Thanks for the updates, those are great changes, making the user aware of the recommended dev tool.
I wanted to check the changes in an actual PDF, and tried but failed to generate a PDF. So I created an issue on how to get DDEV ready to do this. As soon as that's ready, I'll review this issue.
On another side note, I saw that some links use http://, like http://redcrackle.com/ and these links could be updated to use
https://
-- in fact this could even be an issue in itself -- so I created one :) - π©π°Denmark ressa Copenhagen
I managed to get a PDF generated, and your updates, reordering and additions are perfect, beyond my expectations. You goals about guiding new uncertain users in the right direction have certainly been met, so thanks for making this improvement!
Just a single comment about "Quickstart", and then it should be good to go.
I thought about stating even more explicitly that Composer is included in DDEV, but this sentence is probably enough to convey that:
Set up a local development environment using DDEV to serve the application and Composer to download the required files.
- π©π°Denmark ressa Copenhagen
Thanks! This looks great, and it is ready.
-
eojthebrave β
committed 3982eda9 on 11.x
Issue #3469039 by eojthebrave, ressa: Add information about using DDEV...
-
eojthebrave β
committed 3982eda9 on 11.x
- πΊπΈUnited States Amber Himes Matz Portland, OR USA
Just some minor grammatical issues:
1. source/en/install-ddev.asciidoc: The title, "Setting Up An Environment with DDEV" should have lowercase "an": Setting Up an Environment with DDEV" to be consistent with the other titles in the guide.
2. source/en/install-ddev.asciidoc : Change "DDEV specific" to "DDEV-specific" in 2 places (line 28 and 169).
3. source/en/install-prepare.asciidoc: Add comma after "provider". Lines 39-41. Change sentence to:Composer and manual download options; if you chose other options, like a one-click installer from a hosting provider, consult the relevant documentation for any additional steps.
That's all I found. Thank you for making this change. +100 for being opinionated about recommending a specific local development environment. I think it's so much more helpful to newcomers than a "Choose Your Own Adventure from many options" approach.
-
eojthebrave β
committed 1cc85bea on 11.x
Issue #3469039 by amber himes matz: Copy edits for new DDEV content.
-
eojthebrave β
committed 1cc85bea on 11.x
- πΊπΈUnited States eojthebrave Minneapolis, MN
Thanks for reviewing this Amber. I've made those edits.
- π©π°Denmark ressa Copenhagen
It's great to hear that you agree with this addition @amber, and thanks to both of you for maintaining the User Guide, it's truly a great resource.
Automatically closed - issue fixed for 2 weeks with no activity.