On Mon, Apr 20, 2015 at 10:03 PM, Lisa Nguyen <lisa.ngu...@linaro.org> wrote:
> Update the README file with bugs, questions, and contribution
> sections and fix the format for readability.
>
> Signed-off-by: Lisa Nguyen <lisa.ngu...@linaro.org>

Feel free to add my ack and commit.

> ---
> Changes in v2:
> * Removed references to LAVA
> * Rewritten Additional Notes section of README
> * Replace the phrase "Linux devices" with hardware to be more generic
>
>  README | 76 
> ++++++++++++++++++++++++++++++++++++++++++++++++++++--------------
>  1 file changed, 60 insertions(+), 16 deletions(-)
>
> diff --git a/README b/README
> index 2eef1c4..b976727 100644
> --- a/README
> +++ b/README
> @@ -1,5 +1,5 @@
> -General Info
> -============
> +Commands
> +========
>  - In order to run the tests, invoke as root:
>
>         make check
> @@ -12,20 +12,64 @@ General Info
>
>         make -C cpufreq check
>
> -- The test specifications can be found at
> +
> +Test Specifications
> +===================
> +The test specifications can be found at:
>
>  
> https://wiki.linaro.org/WorkingGroups/PowerManagement/Resources/TestSuite/PmQaSpecification
>
> -Other info
> -==========
> -- PM-QA is one of the tools in the external opensource modules in the 
> external
> -  path of android. For building on android, the makefile Android.mk is used 
> to
> -  build the testsuite with a makefile for each subtest.
> -- Incase you are extending a subtest, say a new script which will test a
> -  feature. Add the test number in the Android.mk, in addition to this if its
> -  using a source file (say .c), add the source file in the Android.mk so that
> -  it gets built.
> -- LAVA scripts are used to trigger the pm-qa tests.
> -- Similarly for non-android adding a script and txt (test description) pair 
> is
> -  needed to extent the suite.
> -=======
> +
> +Bugs
> +====
> +If you believe that you have encountered a bug, please file a bug report on
> +Linaro Bugzilla at https://bugs.linaro.org. Once you log in, click on
> +"New" --> "Power Management" --> "PM-QA" as the component. Then fill
> +in the form.
> +
> +Helpful tips for filing a bug report:
> +    1. Provide logs, be verbose as possible
> +    2. Outline steps to reproduce the bug
> +    3. Describe the environment you are running PM-QA on (e.g. Android,
> +        OpenEmbedded, Ubuntu, etc.)
> +    4. What hardware you're using
> +
> +Questions/Comments
> +==================
> +Please submit questions and comments to the linaro-dev mailing list at
> +linaro-dev@lists.linaro.org with "PM-QA" as part of the subject.
> +
> +Contributions
> +=============
> +If you wish to submit patches to improve PM-QA, please send them to
> +the linaro-dev mailing list at linaro-dev@lists.linaro.org with
> +"PATCH PM-QA" as the subject prefix.
> +
> +All scripts in PM-QA must be POSIX-compliant and cannot use any
> +bashisms. At a minimum, they must run in Android and Ubuntu
> +environment and have text files that include their descriptions.
> +
> +Additional notes on new tests
> +=============================
> +PM-QA can be extended with more functional tests by following a few
> +simple rules.
> +
> +a. Add the test (usually a shell script) and its associated
> +description (in a .txt file with the same name) in the appropriate
> +subdirectory
> +b. Change the Android.mk makefile in the subdirectory as appropriate.
> +You will need to change the 'test_num' variable at a minimum. If
> +you're using other source files (say .c), add that to the makefile as
> +well.
> +c. Create a draft specification for your test that can be added to the
> +wiki page[1]
> +d. Make sure your shell scripts do not use bash-specific constructs.
> +Run them with the #!/bin/sh as the interpreter directive instead of
> +#!/bin/bash.
> +e. PM-QA can be found in the external opensource modules in the
> +external path of android sources hosted at Linaro. It is synced with
> +the latest version of PM-QA everytime a new release is made.
> +Android.mk makefiles are used to build the test suite - there is one in
> +each sub-directory.
> +
> +[1] 
> https://wiki.linaro.org/WorkingGroups/PowerManagement/Resources/TestSuite/PmQaSpecification
> --
> 1.9.1
>
_______________________________________________
linaro-dev mailing list
linaro-dev@lists.linaro.org
https://lists.linaro.org/mailman/listinfo/linaro-dev

Reply via email to