| 1 |
#### Gentoo x86 QA website - Report #4 #### |
| 2 |
#### Date: 2010-07-07 #### |
| 3 |
Name: John-Patrik Nilsson |
| 4 |
IRC: <mindbug> |
| 5 |
email: themindbug@×××××.com |
| 6 |
|
| 7 |
|
| 8 |
#### General information #### |
| 9 |
All the code and documentation belonging to this project can be found on |
| 10 |
github: |
| 11 |
|
| 12 |
github.com/mindbug/gentoo_qa-website |
| 13 |
|
| 14 |
|
| 15 |
#### Project progress #### |
| 16 |
Work is being done on the search page this week, still. It is after all |
| 17 |
the most important part of the website/interface. Notes and guidelines |
| 18 |
about this search view has now been added to the README file of the |
| 19 |
django_gentoo_pkg directory, but they are really nothing but common |
| 20 |
sense, having to do with designing a pleasant user experience. This |
| 21 |
functionality is built into Django, so the magic is all there, for the |
| 22 |
developer it is just a matter of using it. |
| 23 |
|
| 24 |
The general idea is that the user can use the website to search for QA |
| 25 |
reports and their packages in various manners. Obviously, all packages |
| 26 |
are assumed to have (be related to) one or more QA reports, else it has |
| 27 |
no business being in the database/website and thus should be removed. |
| 28 |
|
| 29 |
Example use cases: |
| 30 |
User wants to browse the database and have a look-around. |
| 31 |
User wants to look up QA information about a specific package. |
| 32 |
User wants to look up all packages which have a certain keyword |
| 33 |
(~arch). |
| 34 |
User wants to look up all packages which are subjects to a specific |
| 35 |
QA mark, for example the packages which has had a keyword for too |
| 36 |
long and thus is marked as being stale-unstable. |
| 37 |
|
| 38 |
Below is a preliminary list with the queries deemed useful. |
| 39 |
|
| 40 |
Search all packages by any or all of: name, category, |
| 41 |
version, QAReport.qa_class, QAReport.keywords. (Note, code with |
| 42 |
possibility of extending these criteria.) |
| 43 |
|
| 44 |
This work is done in the following files so far: |
| 45 |
django_gentoo_pkg/simple_qa/views.py |
| 46 |
django_gentoo_pkg/simple_qa/forms.py |
| 47 |
django_gentoo_pkg/templates/simple_qa/search*.html |
| 48 |
|
| 49 |
Work is going to continue on this functionality of searching through the |
| 50 |
database until at least the above use cases has been implemented. This |
| 51 |
is imperative to the success of the project. I project it will take me |
| 52 |
until Sunday to complete this in its most hackish way. Of course, |
| 53 |
testing is being done with bogus packages in the database, since the |
| 54 |
data importer is not yet fully connected to the database. |
| 55 |
|
| 56 |
|
| 57 |
#### Finally #### |
| 58 |
Project overview (github project root directory): |
| 59 |
http://github.com/mindbug/gentoo_qa-website |
| 60 |
|
| 61 |
Project plan & journal: |
| 62 |
http://github.com/mindbug/gentoo_qa-website/doc/plan.txt |
Archives