Project

General

Profile

Actions

Idea #17272

open

Doc site feedback

Added by Peter Amstutz almost 4 years ago. Updated 9 months ago.

Status:
New
Priority:
Normal
Assigned To:
-
Category:
Documentation
Target version:
Start date:
Due date:
Story points:
-
Release:
Release relationship:
Auto

Description

  • How you interact with Arvados in the big picture
    • Getting started
    • Guiding you to the right section based on what you want to do
    • Quick start -- bare minimum you need to know
  • Organize around personas:
    • User (do stuff with command line and web)
    • Developer (create pipelines, create stuff using API)
    • Admin (install & manage system)
  • More user-oriented sections instead of developer / devops
  • Put SDK/API/Architecture under "Developer reference"
  • Architecture showing each subsystem and which components are involved
  • Better layout for sections instead of very tall table of contents
  • Glossary
  • Better front page
    • Shrink the front page banner with Dax
    • Replace lower right "Sections" (redundant) with information
  • What to do with the top bar
    • Maybe turn it into breadcrumbs to get back out
  • Reference section of all the command line tools (with how to install / use)
  • New documentation for the "arvados-client" and "arvados-server" subcommands.

First step do some wireframes / mockups / sketches of new layout.

Actions

Also available in: Atom PDF