discoproject/disco — Issue #297: duplication of examples/tutorial material between tutorial.html and install.html
Author: Dieterbe
Created: 2012-02-01 17:23:49+00:00
State: open

* the tutorial document contains good examples such as count_words.py
* but install.html also explains count_words.py under "Test the System"

this is redundant, also the tutorial contains more information anyway.
my suggestion is in install.html, under "Test the System", to just say something like:

Disco should be ready to use...
Head over to the Tutorial to see how to actually start running jobs on Disco.
If anything fails, see the section about Troubleshooting Disco installation.

Also, about the tutorial document, I suggest to put "Run a job" first on the page, because it doesn't rely on any of the other steps (preparing input data or writing functions), so users can test their setup by running a job right away.

I can implement changes like these if you agree with me.