Project

General

Profile

Actions
Copy link

Bug #13690

closed

[Composer] Document install & use of Composer

Added by Tom Morris almost 6 years ago. Updated over 5 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Peter Amstutz
Category:
-
Target version:
2018-08-01 Sprint
Story points:
1.0
Release:
Arvados 1.2
Release relationship:
Auto

Description

The Arvados Composer package appears to be completely undocumented for both sysadmins and users.

Please add it to the documentation for both.

Subtasks 4 (0 open — 4 closed)

Task #13718: Add admin docsResolvedPeter Amstutz07/12/2018Actions
Task #13719: Add user tutorialResolvedPeter Amstutz07/26/2018Actions
Task #13720: Review install docsResolvedNico César07/12/2018Actions
Task #13735: Review 13690-composer-user-guideResolvedTom Morris07/26/2018Actions

Related issues

Related to Arvados - Idea #13799: Organize manual install docs into sectionsResolvedPeter Amstutz07/12/2018Actions
Actions
Copy link
 #1

Updated by Peter Amstutz almost 6 years ago

  • Assigned To set to Peter Amstutz
Actions
Copy link
 #3

Updated by Peter Amstutz almost 6 years ago

  • Related to Idea #13799: Organize manual install docs into sections added
Actions
Copy link
 #4

Updated by Peter Amstutz almost 6 years ago

  • Status changed from New to In Progress
Actions
Copy link
 #5

Updated by Peter Amstutz almost 6 years ago

  • Target version changed from 2018-07-18 Sprint to 2018-08-01 Sprint
Actions
Copy link
 #6

Updated by Tom Morris over 5 years ago

  • Release set to 13
Actions
Copy link
 #7

Updated by Peter Amstutz over 5 years ago

13690-composer-user-guide @ 904e0b03fd558491d9dee39d7679a6c77eb6abd5

Actions
Copy link
 #8

Updated by Tom Morris over 5 years ago

Doc review:
  • add branch points / cross-references to appropriate places in the existing command line oriented documentation (as mentioned in chat)
  • Remove analysis from "The Arvados Workflow Composer is a graphical interface for building Common Workflow Language (CWL) analysis workflows to run on Arvados."
  • Need to explain that changes aren't saved automatically and how to find the Save button
  • probably needs some words about what goes in the Docker repo field and how to find appropriate repos
  • Step 11 - need to switch back to "Home" tab first to find "new workflow" button
  • remove extra "and" in steps 13 & 15 "Drag and from"
  • Step 19 - warn that it will take several minutes
Composer Bugs noticed while doing doc review:
  • says "Resolving RDF schema ..." forever
  • Angular ico instead of Arvados
  • can't create a new destination directory from the "New workflow" dialog
  • Field is labeled "Docker repository" but looks like it's actually the name:tag of a Docker image stored in Arvados
  • clunky, unstyled tabs (no corner rounding, etc)
Actions
Copy link
 #9

Updated by Tom Morris over 5 years ago

Updated review comments after figuring out that I needed to click the save icon to get things to work.

Actions
Copy link
 #10

Updated by Peter Amstutz over 5 years ago

  • Status changed from In Progress to Calendar

Tom Morris wrote:

Doc review:
  • add branch points / cross-references to appropriate places in the existing command line oriented documentation (as mentioned in chat)

Added link on "Developing Workflows" (wasn't obvious where else it should go)

  • Remove analysis from "The Arvados Workflow Composer is a graphical interface for building Common Workflow Language (CWL) analysis workflows to run on Arvados."

Fixed

  • Need to explain that changes aren't saved automatically and how to find the Save button

Fixed

  • probably needs some words about what goes in the Docker repo field and how to find appropriate repos

Done

  • Step 11 - need to switch back to "Home" tab first to find "new workflow" button

Done

  • remove extra "and" in steps 13 & 15 "Drag and from"

Fixed

  • Step 19 - warn that it will take several minutes

Done

13690-composer-user-guide @ cd5cd1855c02319ca31410943c4d944133294b17

Actions
Copy link
 #11

Updated by Tom Morris over 5 years ago

LGTM

Actions
Copy link
 #12

Updated by Peter Amstutz over 5 years ago

  • Status changed from Calendar to Resolved
Actions
Copy link

Also available in: Atom PDF