Please record issues/recommendations here regarding ddev-based sprint tools, launched at Drupalcon Nashville in 2018.

Official documentation is at Drupal.org/tools.

CommentFileSizeAuthor
#11 resilio-sync.png26.64 KBbetoscopio
Support from Acquia helps fund testing for Drupal Acquia logo

Comments

kay_v created an issue. See original summary.

kay_v’s picture

Title: Testing of Drupal Community Tools instructions, 2018 » Testing of Drupal Community Tools & related instructions, 2018
Issue summary: View changes
kay_v’s picture

Issue summary: View changes
kay_v’s picture

Issue summary: View changes
kay_v’s picture

At the First Contributors Sprint, instructions on drupal.org/tools were found to be overly brief some contributors.

A collaboratively written and tested page of extended instructions was started in this google doc. It was created the evening before the sprint and used extensively during the First Contributor session; anecdotally, it appears to have provided the level of detail needed for people to get past unfamiliar steps.

kay_v’s picture

Issue tags: +DrupalCON mentoring
tonypbarker’s picture

This works really well for me.

Just a couple of minor documentation improvements:

1) Change link to feed back to this page.

2) Regarding the instruction line: Now extract the archive within the synced folder and open the directory that gets created, then run install_ddev.sh (Linux & Mac) or install_ddev.cmd (Windows)

The command on Mac / Ubuntu is ./install_ddev.sh , just typing install_ddev.sh in terminal won't run this file.

Since the audience is new contributors, Linux users will surely know this but Mac users maybe not - I'm sure it will be helpful for noobs to specify this & whatever the windows command is.

3) Maybe add the cd command for similar reasons to 2)

4) Maybe specify to open terminal for the same reasons.

philipnorton42’s picture

I just tried out the instructions and I had a little bit of trouble extracting the archive as I got a single file out of it instead of a directory. It's not entirely clear what the archive should contain so clarity there would be cool. I initially thought it was something to do with Docker, but it was just my machine being odd.

I've added a comment to the Google Doc, but also adding here for completeness :)

Add something like this should be enough:

If double clicking on the archive produces a file (instead of a directory) then you'll need to extract the tar using a command line tool.

tar -xzf drupal_sprint_package.no_docker.v0.1.1.tar.gz

siliconmeadow’s picture

I got overly excited when I'd heard that ddev was being used for sprint activities, as I have been using it for a while now on an Arch linux laptop.

I've had to work backwards to find that the quicksprint repo and take that apart. Perhaps we could have an appendix for the curious who would like to take the drum apart to see where the noise comes from.

kellyimagined’s picture

I think it might be good to add some documentation on how to grab different branches, as well as configure drush.

betoscopio’s picture

FileSize
26.64 KB

Instructions on Linux does not seem to work for me, following https://www.drupal.org/tools#linux

Resilio screenshot

Eli-T’s picture

It would be awesome if https://www.drupal.org/tools pointed people at https://www.drupal.org/docs/8/install/drupal-8-quick-start-command, which is a much easier and quicker way of setting up a local dev environment for working on issues.

Is there any reason why we aren't taking advantage of this on /tools?

volkswagenchick’s picture

Status: Active » Fixed

Marking as fixed as this is now outdated.

Thanks everyone.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.