Problem/Motivation

The site:export command is a tad overcomplicated. It tries to graft changes onto an existing recipe, and lets you specify any base recipe. Really, it should just use drupal_cms_site_template_base (if available) by default, and always overwrite the relevant information in recipe.yml and composer.json.

What this gives us, really, is the best possible UX and DX: drush site:export is what you run, with no additional arguments or options, and you get a complete, working recipe with documentation, tests, and a screenshot.

Issue fork drupal_cms-3579616

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

About issue forks

Comments

phenaproxima created an issue. See original summary.

phenaproxima opened merge request !853

phenaproxima’s picture

phenaproxima
he/him
Primary language English
Location Massachusetts
commented
Issue summary: View changes

  • phenaproxima committed 62440fd0 on 2.x 
    feat (drupal_cms_helper): #3579616 The site:export command should always...

  • phenaproxima committed c72081fd on 2.1.x 
    feat (drupal_cms_helper): #3579616 The site:export command should always...
phenaproxima’s picture

phenaproxima
he/him
Primary language English
Location Massachusetts
commented
Status: Active » Fixed

I'm glad I got this done now, because this is really really necessary for 2.1.0 and DrupalCon Chicago, where site templates are making their Big Debut. The tools for creating them need to be working well and finely tuned.

As the initial marketplace-ready site template pilot group submits their work, it's become very obvious where the pitfalls are. This process needs to be easy and relatively foolproof. Even if the monolithic recipes it generates make developers squirm, steering people towards the site template starter kit, and a command they can run without having to know the ins and outs of recipes, is the right move.

Therefore, merged into 2.x and cherry-picked to 2.1.x.

Now that this issue is closed, review the contribution record.

As a contributor, attribute any organization that helped you, or if you volunteered your own time.

Maintainers, credit people who helped resolve this issue.

Status: Fixed » Closed (fixed)

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

ressa’s picture

ressa
he/him
commented

Thanks @phenaproxima, this innovation is pretty exciting, so big thanks to you and the recipe / site template team for all your hard work on making it happen!

I saw the blog post today on Planet Drupal https://www.drupal.org/blog/not-just-a-starting-point-a-head-start-drupa...

... so I looked for documentation under the natural place about recipes and site templates (https://www.drupal.org/docs/develop) but did not find anything and created #3582391: Document site templates and recipes on drupal.org. Then I remembered there actually is documentation, but somewhere else (https://project.pages.drupalcode.org) and created a basic page with links to guide curious drupal.org/docs users to the existing docs:

https://www.drupal.org/docs/develop/creating-recipes-and-site-templates

If you have permission, perhaps it can be added to the menu? Thanks!