summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPatrick Georgi <patrick@georgi-clan.de>2013-12-07 10:38:42 +0100
committerPatrick Georgi <patrick@georgi-clan.de>2013-12-07 18:09:41 +0100
commit7f68dfd6e8d90516a25d0b7523387ea1b8704355 (patch)
treed69e357f988f220fc2b344b11f740b9f60ceebb5
parent16cbf8983c2481a31357f25c44a09b670edcf870 (diff)
board-status: document the wiki scripts
These were terribly under-documented Change-Id: I285ea083110d87076281e81065f5f38d0c688358 Signed-off-by: Patrick Georgi <patrick@georgi-clan.de> Reviewed-on: http://review.coreboot.org/4491 Tested-by: build bot (Jenkins) Reviewed-by: Alexandru Gagniuc <mr.nuke.me@gmail.com>
-rw-r--r--util/board_status/to-wiki/README39
1 files changed, 39 insertions, 0 deletions
diff --git a/util/board_status/to-wiki/README b/util/board_status/to-wiki/README
new file mode 100644
index 0000000000..2bdff5a6af
--- /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.