QA » openQA Project

I think this is quite important. The only separate documentation for os-autoinst should be "this is how you run os-autoinst without OpenQA" and likewise for OpenQA if it is practical to run it with something other than os-autoinst. I think perhaps there has been some progress on this since it was posted though?

To publish the documentation the recommended way seems to be to use travis and scripts to publish to the gh-pages branch, e.g. see

• http://stackoverflow.com/questions/23277391/how-to-publish-to-github-pages-from-travis-ci
• https://gist.github.com/domenic/ec8b0fc8ab45f39403dd
• https://github.com/steveklabnik/automatically_update_github_pages_with_travis_example

If concerned about travis pushing something to our repository then one could create another fork and only give push access there.
If you are still not convinced I I suggest to use ci.opensuse.org and trigger the doc building and publishing there.

Triggering from ci.opensuse.org SGTM :)

can you tell me what you don't like about the first two proposals?

github has updated the procedure how to interact with github pages, should make it even easier for us: https://github.com/blog/2289-publishing-with-github-pages-now-as-easy-as-1-2-3

http://open.qa/api/testapi/#_assert_screen does not seem to be up-to-date after https://github.com/os-autoinst/os-autoinst/pull/690 got merged. when is a regeneration of os-autoinst doc triggered?

we need to create a push to master of openQA repo. There is hopefully activity on openQA repo that we don't have to create something artificial

My original idea was that os-autoinst publishes his own gh-pages and the
openQA doc page only statically references the os-autoinst gh-pages.

documentation publishing does not work anymore -> https://travis-ci.org/os-autoinst/openQA/jobs/192442200

The output has been generated at /tmp/openqa-doc-yc3e/output
Cloning into 'out'...
remote: Counting objects: 29731, done.
remote: Compressing objects: 100% (26/26), done.
remote: Total 29731 (delta 5), reused 0 (delta 0), pack-reused 29705
Receiving objects: 100% (29731/29731), 16.51 MiB | 16.35 MiB/s, done.
Resolving deltas: 100% (20092/20092), done.
Branch gh-pages set up to track remote branch gh-pages from origin.
Switched to a new branch 'gh-pages'
mkdir: cannot create directory ‘docs’: File exists
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 49270  100 49270    0     0   613k      0 --:--:-- --:--:-- --:--:--  616k
Transforming testapi.asciidoc
[gh-pages ba8ed0c2] Update documentation to commit 02196b5
 5 files changed, 69219 insertions(+), 7036 deletions(-)
 create mode 100644 docs/openqa-documentation-20170116_02196b5.html
 create mode 100644 docs/openqa-documentation-20170116_02196b5.pdf
Warning: Permanently added the RSA host key for IP address '192.30.253.112' to the list of known hosts.
Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

https://github.com/os-autoinst/openQA/commit/19e0f8316e176794c3c19900049fb7ab2f504cf0 - I found the bug. But there is a new problem: we need to make sure it only runs once, we now have 4 tests that run in parallel

this has been resolved IMO