Project

General

Profile

Actions

Idea #7996

closed

[Documentation] Install guide guides people to install and configure keep-web

Added by Brett Smith over 8 years ago. Updated about 8 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
Documentation
Target version:
Story points:
0.5

Description

  • Add node(s) and certificate(s) for keep-web in the Prerequisites, as applicable. (I don't know what's applicable.)
  • keep-web needs a page in the install guide. [It already has one.]
  • This page is linked in the TOC. [Uncomment the link in the current TOC.]
  • Add details to the Workbench configuration section such that file downloads are served through keep-web.

Subtasks 3 (0 open3 closed)

Task #8144: Add keep-web to TOCResolvedTom Clegg12/11/2015Actions
Task #8145: Make sure workbench and keep-web doc pages are coherentResolvedTom Clegg12/11/2015Actions
Task #8038: review 7996-keep-web-docResolvedTom Clegg12/11/2015Actions
Actions #1

Updated by Brett Smith over 8 years ago

  • Target version set to Arvados Future Sprints
Actions #2

Updated by Brett Smith over 8 years ago

  • Description updated (diff)
  • Story points set to 0.5
Actions #3

Updated by Brett Smith over 8 years ago

  • Target version changed from Arvados Future Sprints to 2016-01-06 sprint
Actions #4

Updated by Tom Clegg over 8 years ago

  • Assigned To set to Tom Clegg
Actions #5

Updated by Brett Smith over 8 years ago

  • Assigned To deleted (Tom Clegg)
  • Target version changed from 2016-01-06 sprint to Arvados Future Sprints
Actions #6

Updated by Brett Smith about 8 years ago

  • Target version changed from Arvados Future Sprints to 2016-01-20 Sprint
Actions #7

Updated by Tom Clegg about 8 years ago

  • Assigned To set to Tom Clegg
Actions #8

Updated by Tom Clegg about 8 years ago

  • Status changed from New to In Progress
Actions #9

Updated by Tom Clegg about 8 years ago

7996-keep-web-doc

Re: "Add details to the Workbench configuration section such that file downloads are served through keep-web"

I didn't change the Workbench page, so we still have a "go back to workbench and change config" step while installing keep-web.
  • It seems like the alternative is to say something on the Workbench page like "go read about keep-web and decide how you're going to set that up, then come back here to type your Workbench config", which seems (at least) as confusing/disruptive.
  • Getting Workbench alive unblocks a bunch of other testing and troubleshooting opportunities, so making it harder/slower to set it up seems like a move in the wrong direction.
Actions #10

Updated by Radhika Chippada about 8 years ago

Branch 7996-keep-web-doc lgtm.

As for the install guide issue, I also think that it would be confusing to talk about keep-web in workbench installation if we were to assume that the user is going through the docs in order. It seems like talking about workbench config inside the keep-web guide for the keep-web config portion seems fair.

Actions #11

Updated by Tom Clegg about 8 years ago

  • Status changed from In Progress to Resolved

Applied in changeset arvados|commit:b512c81509ce2264916482f01d0a968228d9c94e.

Actions

Also available in: Atom PDF