Project

General

Profile

Actions

Idea #15964

closed

Remove qr1hi from docs

Added by Peter Amstutz over 4 years ago. Updated over 3 years ago.

Status:
Resolved
Priority:
Normal
Assigned To:
Category:
Documentation
Target version:
Start date:
08/20/2020
Due date:
Story points:
-
Release relationship:
Auto

Subtasks 1 (0 open1 closed)

Task #15970: Review 15964-fix-docsResolvedPeter Amstutz08/20/2020Actions

Related issues

Blocked by Arvados - Task #15994: New playground instanceResolved08/10/2020Actions
Actions #1

Updated by Peter Amstutz over 4 years ago

  • Assigned To set to Peter Amstutz
Actions #2

Updated by Peter Amstutz over 4 years ago

Turns out I can't easily do this because we don't have a new playground instance to host stuff that the current instructions tell you to get from qr1hi.

Actions #3

Updated by Peter Amstutz over 4 years ago

  • Target version changed from 2020-01-15 Sprint to 2020-01-29 Sprint
Actions #4

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-01-29 Sprint to 2020-02-12 Sprint
Actions #5

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-02-12 Sprint to 2020-02-26 Sprint
Actions #6

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-02-26 Sprint to 2020-03-11 Sprint
Actions #7

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-03-11 Sprint to 2020-03-25 Sprint
Actions #8

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-03-25 Sprint to 2020-04-08 Sprint
Actions #9

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-04-08 Sprint to 2020-04-22
Actions #10

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-04-22 to 2020-05-06 Sprint
Actions #11

Updated by Peter Amstutz about 4 years ago

  • Target version changed from 2020-05-06 Sprint to 2020-05-20 Sprint
Actions #12

Updated by Peter Amstutz almost 4 years ago

  • Target version changed from 2020-05-20 Sprint to 2020-06-03 Sprint
Actions #13

Updated by Peter Amstutz almost 4 years ago

  • Target version changed from 2020-06-03 Sprint to 2020-06-17 Sprint
Actions #14

Updated by Peter Amstutz almost 4 years ago

  • Target version changed from 2020-06-17 Sprint to 2020-07-01 Sprint
Actions #15

Updated by Peter Amstutz almost 4 years ago

  • Status changed from New to In Progress
Actions #17

Updated by Peter Amstutz almost 4 years ago

  • Target version changed from 2020-07-01 Sprint to 2020-07-15
Actions #18

Updated by Peter Amstutz almost 4 years ago

  • Target version changed from 2020-07-15 to 2020-08-12 Sprint
Actions #19

Updated by Peter Amstutz over 3 years ago

  • Release set to 25
Actions #20

Updated by Peter Amstutz over 3 years ago

  • Target version changed from 2020-08-12 Sprint to 2020-08-26 Sprint
Actions #21

Updated by Peter Amstutz over 3 years ago

15964-fix-docs is ready for a first look.

The original goal was to eliminate the references to qr1hi. This meant that it was blocked on the new playground being set up. I've since made sure that jutro and pirca should be set up properly to match the guide.

I also ended up going over a number of pages and reorganizing them for clarity, as well as deleting obsolete documentation.

The workbench sections still reference workbench 1, but I think updating it for Workbench 2 won't be so bad.

We also want to incorporate the big WGS demo/walkthrough that Sarah is working on, but that will be a different story.

Actions #22

Updated by Lucas Di Pentima over 3 years ago

Some comments:

  • At file build/run-tests.sh line 1033 we’re still pointing to qr1hi to do the link checking. Not sure if this is being used, but worth mentioning it.
  • At file lib/config/config.default.yml line 1287 we also reference qr1hi on an example URL. This gets included in the docs site.
  • At file doc/user/getting_started/ssh-access-windows.html.textile.liquid
    • line 12 it says “…If you would like to use to access VM through your browser…” and might need some clarification.
    • “OS X” is called “macOS” since 2016 (in case you want to be picky about doc correctness 🙂)
  • At file doc/user/tutorials/add-new-repository.html.textile.liquid line 12: typo “acess"
  • The following files could be deleted, as it seems they aren’t being included anywhere.
    • doc/_includes/_0_filter_py.liquid
    • doc/_includes/_alert-incomplete.liquid
    • doc/_includes/_alert_stub.liquid
    • doc/_includes/_arv_copy_expectations.liquid
    • doc/_includes/_concurrent_hash_script_py.liquid
    • doc/_includes/_crunch1only_begin.liquid
    • doc/_includes/_crunch1only_end.liquid
    • doc/_includes/_example_docker.liquid
    • doc/_includes/_install_git.liquid
    • doc/_includes/_install_rails_reconfigure.liquid
    • doc/_includes/_install_ruby_and_bundler_sso.liquid
    • doc/_includes/_install_runit.liquid
    • doc/_includes/_pipeline_deprecation_notice.liquid
    • doc/_includes/_run_command_foreach_example.liquid
    • doc/_includes/_run_command_simple_example.liquid
    • doc/_includes/_run_md5sum_py.liquid
    • doc/_includes/_tutorial_bwa_sortsam_pipeline.liquid
    • doc/_includes/_tutorial_cluster_name.liquid
    • doc/_includes/_tutorial_hash_script_py.liquid
    • doc/_includes/_tutorial_submit_job.liquid
  • At file doc/user/topics/arv-docker.html.textile.liquid the "x20vs" cluster references could be replaced with “zzzzz” for consistency with other examples.
  • At file doc/_includes/_install_compute_docker.liquid line 9 there’s a mention of “pipeline” that might be confusing
  • At file doc/user/getting_started/workbench.html.textile.liquid line 26 — the same as above.
Actions #23

Updated by Peter Amstutz over 3 years ago

I made all the changes suggested above

15964-fix-docs @ 8a41cc44ee196c9347785baa476a370abe77c75c

Actions #24

Updated by Lucas Di Pentima over 3 years ago

This LGTM, thanks!

Actions #25

Updated by Peter Amstutz over 3 years ago

  • Status changed from In Progress to Resolved
Actions

Also available in: Atom PDF