Project

General

Profile

Actions
Copy link

Bug #5194

closed

[Documentation] User guide doesn't link to or acknowledge new "Getting Started" section

Added by Peter Amstutz about 9 years ago. Updated about 9 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
-
Category:
-
Target version:
2015-02-18 sprint
Story points:
-

Description

The User Guide has its own section labled "Getting started" which is confusing with the new (much better) "Getting Started" section.

Subtasks 1 (0 open — 1 closed)

Task #5243: Review branch 5194-quickfix-disambiguate-gettingstarted-sectionsResolvedRadhika Chippada02/17/2015Actions
Actions
Copy link
 #1

Updated by Peter Amstutz about 9 years ago

  • Description updated (diff)
Actions
Copy link
 #2

Updated by Nancy Ouyang about 9 years ago

Note about task #5243:
This is a quick fix only.
  • I disambiguated "user guide" vs "getting started" sections with some text
  • I renamed "getting started" in the left navbar of the "user guide" to "welcome" to create less confusion
  • I added "next steps" linking to the "user guide" in "getting started"
Actions
Copy link
 #3

Updated by Radhika Chippada about 9 years ago

Review comments:

Looks much better and clears the confusion with disconnected "Getting started" sections. Just a few minor suggestions.

- nextsteps.html

  • “Now that you’ve finished the Getting …” => can we say “Now that you’ve read the Getting …”
  • “commandline” => can you make it “command line”

- User guide -> Welcome to Arvados

  • “This is the User Guide. If you are new to Arvados and want to get started quickly, go to Getting Started instead.” => I think no need to say “This is the User Guide.”. I think saying something like “If you are new to Arvados, please read Getting Started guide for quick introduction to working with Arvados” would be nicer.
Actions
Copy link
 #4

Updated by Radhika Chippada about 9 years ago

  • Status changed from New to In Progress
  • Assigned To set to Nancy Ouyang
  • Target version changed from Bug Triage to 2015-02-18 sprint
Actions
Copy link
 #5

Updated by Nancy Ouyang about 9 years ago

  • Status changed from In Progress to New
  • Assigned To deleted (Nancy Ouyang)
  • Target version changed from 2015-02-18 sprint to Bug Triage
  • I kept "finished" because hopefully they ran their first pipeline in addition to reading the guide
  • fixed
  • fixed
Actions
Copy link
 #6

Updated by Nancy Ouyang about 9 years ago

  • Status changed from New to In Progress
  • Target version changed from Bug Triage to 2015-02-18 sprint
Actions
Copy link
 #7

Updated by Anonymous about 9 years ago

  • Status changed from In Progress to Resolved

Applied in changeset arvados|commit:9c8bad50218730ac2c640f8e1c00fd12f2f174e4.

Actions
Copy link
 #8

Updated by Peter Amstutz about 9 years ago

This is great, thanks.

Actions
Copy link

Also available in: Atom PDF