No edit summary |
No edit summary |
||
| Line 5: | Line 5: | ||
As such, it provides just a simple UI for submitting results (for the users), 'events' are created based on a simple metadata format (that will be described next in the text), and the results can be exported into the wiki-syntax tables, so we don't loose the "all the results are stored in wiki pages" concept. Feel free to try it out at [http://testdays.qa.fedoraproject.org/testdays/show_event?event_id=9]. | As such, it provides just a simple UI for submitting results (for the users), 'events' are created based on a simple metadata format (that will be described next in the text), and the results can be exported into the wiki-syntax tables, so we don't loose the "all the results are stored in wiki pages" concept. Feel free to try it out at [http://testdays.qa.fedoraproject.org/testdays/show_event?event_id=9]. | ||
= How to | = How to use the TestdayApp = | ||
== Create a wikipage containing metadata == | == Create a wikipage containing metadata == | ||
| Line 21: | Line 21: | ||
Then simply copy-paste the whole url of the wiki-page containing metadata (e.g. https://fedoraproject.org/wiki/User:Jskladan/Sandbox:TestdayAppMockTestday ) into the form, and hit the Submit button. New event will be created, and you can find it on the TestdayApp's main page [http://testdays.qa.fedoraproject.org/testdays/all_events]. | Then simply copy-paste the whole url of the wiki-page containing metadata (e.g. https://fedoraproject.org/wiki/User:Jskladan/Sandbox:TestdayAppMockTestday ) into the form, and hit the Submit button. New event will be created, and you can find it on the TestdayApp's main page [http://testdays.qa.fedoraproject.org/testdays/all_events]. | ||
== Updating/changing the event == | === Updating/changing the event === | ||
Should you decide to change the metadata - and this can mean anything from adding testcases, to renaming it, or moving it into some other group, just edit the metadata wiki page, and proceed like you were creating a new testcase (visit [http://testdays.qa.fedoraproject.org/testdays/admin/update_testday], enter the full url and hit Submit). The testcases are identified by the provided URL, so you can move it around, change it's name, or even it's type (whether the result should be from Pass/Fail/Info set or freeform), and the currently submitted results won't be affected or lost. | Should you decide to change the metadata - and this can mean anything from adding testcases, to renaming it, or moving it into some other group, just edit the metadata wiki page, and proceed like you were creating a new testcase (visit [http://testdays.qa.fedoraproject.org/testdays/admin/update_testday], enter the full url and hit Submit). The testcases are identified by the provided URL, so you can move it around, change it's name, or even it's type (whether the result should be from Pass/Fail/Info set or freeform), and the currently submitted results won't be affected or lost. | ||
== | == Export the data == | ||
Once the testday is finished (we usually let people use the tool for a week, then export the data and leave the latecomers with the wiki editing), you should visit the "Export Testday" [http://testdays.qa.fedoraproject.org/testdays/admin/export_testday] section of the admin interface [http://testdays.qa.fedoraproject.org/testdays/admin/]. | Once the testday is finished (we usually let people use the tool for a week, then export the data and leave the latecomers with the wiki editing), you should visit the "Export Testday" [http://testdays.qa.fedoraproject.org/testdays/admin/export_testday] section of the admin interface [http://testdays.qa.fedoraproject.org/testdays/admin/]. | ||
Enter the metadata page's full URL and hit submit to get the results matrix in wiki syntax. This code can then be easily copy-pasted into the testday's wiki page. | Enter the metadata page's full URL and hit submit to get the results matrix in wiki syntax. This code can then be easily copy-pasted into the testday's wiki page. | ||
= Contacts = | |||
Should you encounter any problem, or just seek help, please contact [[User:jskladan]] either via IRC (#fedora-qa channel on freenode) or via email ([jskladan@fedorapeople.org]). | |||
[[Category:TestdayApp]] | [[Category:TestdayApp]] | ||
Revision as of 15:21, 14 October 2013
What is Testday App
TestdayApp [1] is a simple web-application, that allows for easier submissions of testdays' results. It was created as an alternative to the Wiki editing, in a response to numerous calls for a tool that makes the process "entering of results into the wiki" easier.
As such, it provides just a simple UI for submitting results (for the users), 'events' are created based on a simple metadata format (that will be described next in the text), and the results can be exported into the wiki-syntax tables, so we don't loose the "all the results are stored in wiki pages" concept. Feel free to try it out at [2].
How to use the TestdayApp
Create a wikipage containing metadata
The TestdayApp event is described by a simple metadata structure. We use the fedoraproject wiki to store metadata information. The metadata format is described here.
Although the the format itself is quite simple, we know that learning by example is the best, so each 'event' page (e.g. the [3]) has a link called "Wiki Metadata" in the bottom-right corner. This link is pointing to the Metadata page respective to the shown event.
Please use the [4], and it's respective metadata to play-around with the tool.
Create a new event in the TestdayApp
Once you have the metadata page (or a working draft, the event can be updated later on), visit [5], and go to the "Create/Update testday" section [6].
Then simply copy-paste the whole url of the wiki-page containing metadata (e.g. https://fedoraproject.org/wiki/User:Jskladan/Sandbox:TestdayAppMockTestday ) into the form, and hit the Submit button. New event will be created, and you can find it on the TestdayApp's main page [7].
Updating/changing the event
Should you decide to change the metadata - and this can mean anything from adding testcases, to renaming it, or moving it into some other group, just edit the metadata wiki page, and proceed like you were creating a new testcase (visit [8], enter the full url and hit Submit). The testcases are identified by the provided URL, so you can move it around, change it's name, or even it's type (whether the result should be from Pass/Fail/Info set or freeform), and the currently submitted results won't be affected or lost.
Export the data
Once the testday is finished (we usually let people use the tool for a week, then export the data and leave the latecomers with the wiki editing), you should visit the "Export Testday" [9] section of the admin interface [10]. Enter the metadata page's full URL and hit submit to get the results matrix in wiki syntax. This code can then be easily copy-pasted into the testday's wiki page.
Contacts
Should you encounter any problem, or just seek help, please contact User:jskladan either via IRC (#fedora-qa channel on freenode) or via email ([jskladan@fedorapeople.org]).