# Documentation from testing

**URL:** https://discourse.kitware.com/t/documentation-from-testing/271
**Category:** Software Process
**Created:** [June 18, 2019, 6:21pm UTC](https://discourse.kitware.com/t/documentation-from-testing/271 "2019-06-18T18:21:24Z")
**Posts on this page:** 4
**Page:** 1

<div class="post-metadata">

### Author: ![dcthomp](https://discourse.kitware.com/user_avatar/discourse.kitware.com/dcthomp/32/10_2.png) [@dcthomp](https://discourse.kitware.com/u/dcthomp)
#### Post date: [June 18, 2019, 6:21pm UTC](https://discourse.kitware.com/t/documentation-from-testing/271/1 "2019-06-18T18:21:24Z")

</div>

We’ve talked about having both a test-a-thon and a doc-a-thon to get tests and documentation in shape for the upcoming tutorials at KHQ in July.

One thing that would be interesting would be to have the tests generate images for the documentation (or at least using the testing framework to generate images or even movies for the documentation). Ken Martin has [done some work](https://discourse.paraview.org/t/updates-to-virtual-reality-support-in-paraview/2046/6) that exposes portions of the Qt UI to ParaView inside virtual reality; we could probably use the same technique to grab images or movies of Qt XML “tests” for the documentation.

By making portions of the documentation contribute to test results, we could catch at least some places where the documentation becomes out-of-sync with the implementation. It would also reduce the manual effort required to keep figures up-to-date as the modelbuilder UI changes.

---

<div class="post-metadata">

### Author: ![tj.corona](https://discourse.kitware.com/user_avatar/discourse.kitware.com/tj.corona/32/35_2.png) [@tj.corona](https://discourse.kitware.com/u/tj.corona)
#### Post date: [June 18, 2019, 6:42pm UTC](https://discourse.kitware.com/t/documentation-from-testing/271/2 "2019-06-18T18:42:42Z")

</div>

> [@dcthomp](#):
>
> One thing that would be interesting would be to have the tests generate images for the documentation (or at least using the testing framework to generate images or even movies for the documentation).

Cool!

> [@dcthomp](#):
>
> Ken Martin has [done some work](https://discourse.paraview.org/t/updates-to-virtual-reality-support-in-paraview/2046/6) that exposes portions of the Qt UI to ParaView inside virtual reality

Would that require us to be on preview’s master branch?

---

<div class="post-metadata">

### Author: ![Haocheng\_Liu](https://discourse.kitware.com/user_avatar/discourse.kitware.com/haocheng_liu/32/36_2.png) [@Haocheng\_Liu](https://discourse.kitware.com/u/Haocheng_Liu)
#### Post date: [June 18, 2019, 7:23pm UTC](https://discourse.kitware.com/t/documentation-from-testing/271/3 "2019-06-18T19:23:16Z")

</div>

> [@dcthomp](#):
>
> One thing that would be interesting would be to have the tests generate images for the documentation (or at least using the testing framework to generate images or even movies for the documentation). Ken Martin has [done some work](https://discourse.paraview.org/t/updates-to-virtual-reality-support-in-paraview/2046/6) that exposes portions of the Qt UI to ParaView inside virtual reality; we could probably use the same technique to grab images or movies of Qt XML “tests” for the documentation.

Ken mentioned that currently it includes displaying **parts** of the PV GUI directly in VR. Wondering how much needs to be done to show CMB specific panels ❓

---

<div class="post-metadata">

### Author: ![dcthomp](https://discourse.kitware.com/user_avatar/discourse.kitware.com/dcthomp/32/10_2.png) [@dcthomp](https://discourse.kitware.com/u/dcthomp)
#### Post date: [June 19, 2019, 5:14am UTC](https://discourse.kitware.com/t/documentation-from-testing/271/4 "2019-06-19T05:14:57Z")

</div>

> [@tj.corona](#):
>
> Would that require us to be on preview’s master branch?

I assume by “preview” you mean “ParaView”? If so, then yes. This is definitely for after that change (although I think that will be coming shortly after the tutorial in July, yes?

> [@Haocheng\_Liu](#):
>
> Ken mentioned that currently it includes displaying **parts** of the PV GUI directly in VR. Wondering how much needs to be done to show CMB specific panels ❓

Assuming OpenGL widgets are handled properly, very little work… if you look at the classes in Ken’s MR, you just pass in QWidget and it generates a vtkImage texture. So we could try passing in QMainWindow. You are correct that if we want to show dialogs (file dialogs, popups, etc.) that would be more work. But it may even be possible to grab those without much work since the QtTesting framework knows when events are being passed to widgets not in the main-window hierarchy.
