I was recently looking at the LAVA documentation to see how much would be useful for our latest member, Antonio. In short, our documentation is pretty terrible (which we already new). I've spent most of today trying to help get things a little better. Its by no means complete, but I wanted to share with you where things are at, and what my future plans are.
To begin with, I've changed up our wiki pages a bit. Part of this was because of a request I got to move our pages from /Platform/Validation to /Platform/LAVA. Part of this was to try and improve and remove. The end results are:
A new main page: https://wiki.linaro.org/Platform/LAVA/ * the first few links here are purely for getting started with LAVA * it includes a link to LAVA team oriented stuff: https://wiki.linaro.org/Platform/LAVA/Links
Renaming of many pages under /Platform/Validation such as: * https://wiki.linaro.org/Platform/LAVA/DevOps
A removal of LAVA documentation that's already covered in better detail in our readthedocs pages.
Improvements to http://lava.readthedocs.org: * updated information about our new lava-deployment-tool for install * updated information on creating master images * updated information on adding a device to LAVA * a new page on how to add a QEMU device to LAVA
This is just the tip of the iceberg. The next things I need to look at are: * the accuracy and importance of the wiki pages * the accuracy of the readthedocs
I'll be trying to get this up-to-date as soon as possible. Please let me know if you find an old page missing you used or something that's out of date and I'll try and get it corrected.
-andy
Please note that this means weekly reports are now:
https://wiki.linaro.org/Platform/LAVA/Meetings/2012-09-06
However, there seems to be some formatting issue. Any clues?
Dave Pigott Validation Engineer T: +44 1223 40 00 63 | M +44 7940 45 93 44 Linaro.org │ Open source software for ARM SoCs Follow Linaro: Facebook | Twitter | Blog
On 6 Sep 2012, at 03:56, Andy Doan wrote:
I was recently looking at the LAVA documentation to see how much would be useful for our latest member, Antonio. In short, our documentation is pretty terrible (which we already new). I've spent most of today trying to help get things a little better. Its by no means complete, but I wanted to share with you where things are at, and what my future plans are.
To begin with, I've changed up our wiki pages a bit. Part of this was because of a request I got to move our pages from /Platform/Validation to /Platform/LAVA. Part of this was to try and improve and remove. The end results are:
A new main page: https://wiki.linaro.org/Platform/LAVA/
- the first few links here are purely for getting started with LAVA
- it includes a link to LAVA team oriented stuff:
https://wiki.linaro.org/Platform/LAVA/Links
Renaming of many pages under /Platform/Validation such as:
A removal of LAVA documentation that's already covered in better detail in our readthedocs pages.
Improvements to http://lava.readthedocs.org:
- updated information about our new lava-deployment-tool for install
- updated information on creating master images
- updated information on adding a device to LAVA
- a new page on how to add a QEMU device to LAVA
This is just the tip of the iceberg. The next things I need to look at are:
- the accuracy and importance of the wiki pages
- the accuracy of the readthedocs
I'll be trying to get this up-to-date as soon as possible. Please let me know if you find an old page missing you used or something that's out of date and I'll try and get it corrected.
-andy
linaro-validation mailing list linaro-validation@lists.linaro.org http://lists.linaro.org/mailman/listinfo/linaro-validation
Dave Pigott escreveu isso aí:
Please note that this means weekly reports are now:
https://wiki.linaro.org/Platform/LAVA/Meetings/2012-09-06
However, there seems to be some formatting issue. Any clues?
There was a wiki directive saying
<<Include(Platform/Validation, , from="^## meetings$", to="^## end-meetings$")>>
I changed it to
<<Include(Platform/LAVA, , from="^## meetings$", to="^## end-meetings$")>>
and re-added the from/to markers in Platform/LAVA.
This page looks better now, but the archive of past meetings is still under the /Platform/Validation namespace, and all of them still include that snippet of Platform/Validation, which makes them look broken roght now. I am not sure if we can script a batch update on all those old pages ... I will give it a try while lava-deployment-tool is running. ;-)
linaro-validation@lists.linaro.org
-
Andy Doan -
Antonio Terceiro -
Dave Pigott