[Live-demo] please update app tests..

[Hamish]

Daniel wrote:
> I think that it will be difficult in the future to
> ensure that every project doesn't forget to keep all
> different documents up-to-date: there is a Google Docs
> spreadsheet, the wiki page with tests, quickstart and
> introduction document ... maybe there's even more. I'm
> not sure.

I know.. and it's evolving as we go. I hope with every
iteration we start to settle down more and document the
process better.

> In my opinion the quickstart document would be a
> perfect test and nobody needed to check and update the
> wiki page then. So maybe for the next release it would
> be worth to think about to require a quickstart
> document and write it in a way, that it can be a test
> as well. 

I am not a huge fan of that, as they are for two different
things: the test is to prove if the program install is
functional (libraries, paths, etc) and should be able to
get through in 2-3 minutes. the quickstart is to intro how
to use the program, and could take 10 minutes or more
to get through. but the quickstart needs to be tested too,
and makes a good (long) test.


> Also information that is currently in the spreadsheet
> could for example move into the header of the
> introduction document.

I do not disagree, as I do not enjoy double handling.
I'd rather grep for '**Version' in *_overview.rst to
make up a table dynamically, flag missing files, etc.
But these are matters to think about later in the year,
for now we push through with the best process we've
developed so far and apologize for any conflicting info
in the wiki.


regards,
Hamish