board-status: document the wiki scripts 91/4491/3
authorPatrick Georgi <patrick@georgi-clan.de>
Sat, 7 Dec 2013 09:38:42 +0000 (10:38 +0100)
committerPatrick Georgi <patrick@georgi-clan.de>
Sat, 7 Dec 2013 17:09:41 +0000 (18:09 +0100)
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>
util/board_status/to-wiki/README [new file with mode: 0644]

diff --git a/util/board_status/to-wiki/README b/util/board_status/to-wiki/README
new file mode 100644 (file)
index 0000000..2bdff5a
--- /dev/null
@@ -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.