search

GetDKAN / dkan-tools

CLI tools for DKAN site management
https://getdkan.github.io/dkan-tools/
15 stars 14 forks source link

Reorganize DKAN2 commands for simpler workflows #215

Closed dafeder closed 4 years ago

dafeder commented 4 years ago

The current array of dktl commands and arguments/flags to build and update sites is pretty confusing, and mostly a legacy of what made sense for Drupal 7. Let's start from scratch and think about a clear set of steps to perform essential dev tasks.

One command to rule them all

A simple one-step startup for a new site. Start in parent/projects dir. Creates project dir, initializes, gets and builds codebase, installs site.

dktl new [projectname]

Possible optional arguments

-- projectname starts a new dir in that dir, omitting projectname arg starts in current dir -- branch/tag (default to latest tag) -- demo: true, false (default to true) -- frontend: true (default), false

Reorganized commands

The granular commands for everyday development tasks

  1. dktl init Initialize directory
  2. dktl drupal:get Drupal composer scaffold, docroot symlinks to src
  3. dktl dkan:get Require DKAN
  4. dktl frontend:get Download frontend into src/frontend, npm install, symlink to docroot
  5. dktl install Install Drupal (db), turn on DKAN and other stuff
  6. dktl demo Enable sample content module, create content, run index
  7. dktl frontend:build Build frontend app

More tickets to come to clean up additional commands like tests and "proxy" commands

janette commented 4 years ago

fixed by #253