From 4f92a322148f939ef38faac87e241f8a4060d128 Mon Sep 17 00:00:00 2001 From: Ana C Date: Tue, 29 Sep 2015 09:41:53 +0200 Subject: Reorganize documentation in new structure Remove the to-be-reorganized folder and reorganize documentation in properly named subfolders. Modified conf.py to reflect yardstick project name. Modified index.rst with introduction about yardstick. Templates were moved to new subfolder, no changes in the content. Jira:YARDSTICK-133 Change-Id: Iea5948733c57ff57eb946f44739b69d0e7291356 Signed-off-by: Ana C --- .../templates/testcase_description_template.rst | 88 ++++++++++++++++++++++ 1 file changed, 88 insertions(+) create mode 100644 docs/source/templates/testcase_description_template.rst (limited to 'docs/source/templates/testcase_description_template.rst') diff --git a/docs/source/templates/testcase_description_template.rst b/docs/source/templates/testcase_description_template.rst new file mode 100644 index 000000000..899554dec --- /dev/null +++ b/docs/source/templates/testcase_description_template.rst @@ -0,0 +1,88 @@ +.. NOTE:: + Template to be used for test case descriptions in Yardstick Project. + Write one .rst per test case. + Upload the .rst for the test case in /docs directory. Review in Gerrit. + +****************** +Test Case +****************** + +.. contents:: Table of Contents + :depth: 3 + +--------------------- +Test Case Description +--------------------- + +Yardstick Test Case ID +---------------------- + +OPNFV_YARDSTICK_TC_ + +where: + - : check Jira issue for the test case + - : check Jira issue for the test case + + +Purpose +------- + +Describe what is the purpose of the test case + +Area +---- + +State the area and sub-area covered by the test case. + +Areas: Compute, Networking, Storage + +Sub-areas: Performance, System limit, QoS + +Metrics +------- + +What will be measured, attribute name or collection of attributes, behavior + +References +---------- + +Reference documentation + +-------------- +Pre-requisites +-------------- + +Tools +----- + +What tools are used to perform the measurements (e.g. fio, pktgen) + + +Configuration +------------- + +State the .yaml file to use. + +State default configuration in the tool(s) used to perform the measurements (e.g. fio, pktgen). + +State what POD-specific configuration is required to enable running the test case in different PODs. + +State SLA, if applicable. + +State test duration. + +------- +Results +------- + +Expected outcome +---------------- + +State applicable graphical presentation + +State applicable output details + +State expected Value, behavior, pass/fail criteria + + + -- cgit 1.2.3-korg