new book manual

collections/manual/knowledge_base/collaboration/testing/testing_readme.md

@@ -0,0 +1,52 @@
+<h1>Testing the ThreeFold Grid: Ensuring Reliability and User Feedback</h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Automation Testing](#automation-testing)
+- [Manual Testing](#manual-testing)
+- [Covered Tests](#covered-tests)
+
+***
+
+## Introduction
+
+With each release of a newer version of the ThreeFold Grid, the ThreeFold Community plays a vital role in testing the product components and providing constructive feedback to the engineering team. This article explores the testing strategy employed by ThreeFold, which includes both automation and manual testing, and highlights the covered functionality tested by the procedures.
+
+## Automation Testing
+The internal QA team conducts automation testing, where they automate various test scenarios and run them in nightly builds. This approach helps identify the status of the code and allows for the early detection of functionality and regression issues.
+
+## Manual Testing
+The QA team, along with the grid testing community, performs manual testing. [TestLodge](./testlodge.html) is the chosen platform for managing test plans, test cases, and test runs. By joining TestLodge as a user, individuals can actively participate in running test use cases and reporting any issues encountered during product deployment. Issues can be reported by creating an issue on [ThreeFold's Test Feedback repository](https://github.com/threefoldtech/test_feedback/issues) on Github.
+
+## Covered Tests
+The ThreeFold Grid 3 encompasses a wide range of functionalities that are thoroughly tested to ensure their reliability and performance. Some of the covered functionalities include:
+
+- Compute
+   - Virtual machine
+   - Caprover
+   - Kubernetes
+
+- Network
+   - WebGateway
+   - Planetary Network
+   
+- Storage
+   - Quantum Safe Storage System (Quantum Safe Filesystem)
+   -  0-DB
+   - S3 minio
+
+- TFChain
+   - Portal 
+   -  IPFS
+
+- Farming
+   - Create Farm
+   - Farm Management
+
+- TwinServer v2
+- TerraForm Deployments
+
+Testing is a crucial aspect of the ThreeFold Grid's development process. By actively involving the ThreeFold Community in testing the product components and leveraging automation and manual testing approaches, the engineering team ensures the reliability and quality of the Grid3. 
+
+With TestLodge as the testing platform, users can contribute to the testing efforts by running test use cases and reporting any issues encountered. Through collaborative testing, the ThreeFold Grid continues to evolve and deliver a robust and efficient infrastructure for users worldwide.

collections/manual/knowledge_base/collaboration/testing/testlodge.md

@@ -0,0 +1,95 @@
+<h1>How to Use TestLodge for Testing the ThreeFold Grid</h1>
+
+<h2>Table of Contents</h2>
+
+- [Introduction](#introduction)
+- [Getting Started on TestLodge](#getting-started-on-testlodge)
+  - [Joining the TF GRID Project on TestLodge by Invitation](#joining-the-tf-grid-project-on-testlodge-by-invitation)
+- [Accessing the TF GRID 3.x Projects](#accessing-the-tf-grid-3x-projects)
+  - [Project Overview](#project-overview)
+  - [Creating Your Own Personal Test Run](#creating-your-own-personal-test-run)
+
+***
+
+## Introduction
+
+After each release of a newer version of the ThreeFold Grid, we encourage the ThreeFold Community to participate in testing the grid's product components and provide valuable feedback to our engineering team. To facilitate this process, we have adopted TestLodge as our QA and testing platform. TestLodge allows us to efficiently manage test plans, test cases, and test runs for our products. By joining TestLodge as a user, you can assist us in running test cases and reporting any issues encountered during our product deployment processes.
+
+## Getting Started on TestLodge
+
+### Joining the TF GRID Project on TestLodge by Invitation
+
+To become one of our testers on TestLodge, please request an invitation by joining our official [TF Grid Tester 
+Telegram Group](https://t.me/joinchat/R75FxI_6J6tgn1jK) and sending a personal message to the group's moderator, providing your email address.
+
+Once you receive an invitation, check your email for further instructions and create an account on TestLodge. This will grant you access to the TF GRID Project on TestLodge.
+
+## Accessing the TF GRID 3.x Projects
+
+After successfully creating your account, you can access the TF GRID 3.x Project from your Testlodge dashboard. Simply click on the project to begin the testing process.
+
+### Project Overview
+
+Inside the project, you will find an overview that displays the project's testing environment. Here's a brief description of the project's content:
+
+- Total Test Plans: 
+Indicates the number of test plans or products being tested in this project.
+
+- Total Requirement Docs: 
+Represents the amount of testing documentation provided for each test within the project.
+
+- Total Test Suites: 
+Displays the number of individual test use cases for each product being tested. These test suites are the procedures you will follow as a user/tester.
+
+- Total Test Runs: 
+Reflects the total number of testing rounds conducted by users within the project. Each tester has their own Test Run, which serves as a testing dashboard for reporting test results. To get started with testing the TF Grid Test Suites, you need to create your own Test Run by using your name as the title.
+
+### Creating Your Own Personal Test Run
+To create your personal Test Run, follow these steps:
+
+1. Click on the "Test Runs" tab in the top navigation bar and select "New Test Run."
+
+![](./img/test_run.png)
+
+2. Provide your name as the test name and select "eVDC Deployer" as your test suite since it is a test run for eVDC Deployer. Click on "Select Test Suites and Cases" to view the details of the use cases you want to test.
+
+![](./img/evdc_test.png)
+
+
+3. On the "Select Test Suites and Cases" page, choose the "Deploy a new eVDC" test suite as your Test Suite. This suite includes the different use cases required to deploy an eVDC.
+
+![](./img/deploy_evdc.png)
+
+4. Click "Add Test Run" to complete the registration of your new test run.
+
+![](./img/add_test.png)
+
+
+5. You will see a list of all created test runs, including your own. Click on the test run you just created to access your test run profile.
+
+![](./img/my_test.png)
+
+
+6. In your test run profile, you will find a summary and a list of the test suites you need to run.
+
+![](./img/test_list.png)
+
+7. Click on the "Deploy eVDC" test suite from the list and select "Run Test" to begin testing.
+
+![](./img/run_test.png)
+
+8. Proceed to the eVDC Deployer and commence your test.
+
+![](./img/evdc_home_.jpg)
+
+9. Provide your remarks in the provided comment box and click "Pass," "Fail," or "Skip" based on the result of your test run to provide feedback to the ThreeFold QA Team.
+
+![](./img/report_test.png)
+
+10. Repeat the previous step to complete all
+
+11. Go back to the ‘test runs’ page to see the overview of all test runs, and make sure that you completed your own test runs as shown below.
+
+![](./img/test_finish.png)
+
+12. Thank you for completing test runs for ThreeFold Grid Project! You can now create an issue on [ThreeFold's Test Feedback repository](https://github.com/threefoldtech/test_feedback/issues) on Github, and report to our development teams about your test findings and feedback.