[coreboot-gerrit] Patch set updated for coreboot: e921560 board-status: document the wiki scripts

[Patrick Georgi (patrick@georgi-clan.de)]

Patrick Georgi (patrick at georgi-clan.de) just uploaded a new patch set to gerrit, which you can find at http://review.coreboot.org/4491

-gerrit

commit e9215606debcc4355bfd7fa34d796583caa72993
Author: Patrick Georgi <patrick at georgi-clan.de>
Date:   Sat Dec 7 10:38:42 2013 +0100

    board-status: document the wiki scripts
    
    These were terribly under-documented
    
    Change-Id: I285ea083110d87076281e81065f5f38d0c688358
    Signed-off-by: Patrick Georgi <patrick at georgi-clan.de>
---
 util/board_status/to-wiki/README | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/util/board_status/to-wiki/README b/util/board_status/to-wiki/README
new file mode 100644
index 0000000..2bdff5a
--- /dev/null
+++ b/util/board_status/to-wiki/README
@@ -0,0 +1,39 @@
+Scripts to publish board-status data to the wiki
+================================================
+
+These scripts parse the board-status repository (and the coreboot repository as companion)
+to build a meaningful representation of the test coverage stored in board-status.
+
+The server runs these nightly (CET/CEST), so no user interaction with the wiki page is needed.
+
+How to use
+----------
+When modifying the scripts, or when publishing the results elsewhere, you might want to run them
+yourself. You'll need the board-status and the coreboot repository checked out side by side, named
+"board-status" and "coreboot" respectively (in particular without .git suffix).
+
+To emit wiki-text, in the board-status repository's top-level directory, run
+
+    $ ../util/board_status/to-wiki/status-to-wiki.sh
+
+The output ends up on stdout, so you'll have to store it yourself, if you need it later.
+
+`push-to-wiki.sh FILENAME` can be used to push a file into the wiki. The page name is hard coded
+in TITLE, while user credentials are looked up in ~/.wikiaccount, which should look like
+
+    USERNAME=user
+    USERPASS=password
+
+How it works
+------------
+status-to-wiki collects the reports and sorts them in buckets by report date. These can have
+weekly, monthly and quarterly granularity.
+It then passes these into the towiki script, which reads the data in more details and prints
+them in the output format.
+
+Contributions
+-------------
+These scripts are rather bare, and you're welcome to extend them to extract more useful data
+from both repositories, and to present the data in a nicer way.
+A rewrite into another (reasonable) language is fine, too - shell quickly finds its limits
+for this kind of text processing.