Merge pull request #519 from testsigmahq/dev

Added a new doc for Folder Structure (#518)

src/left-nav-title.json

@@ -680,5 +680,6 @@
   "projects-and-applications": {"/docs/windows-lite-automation/projects-and-applications/": "Windows (Lite) Project & Application"},
   "element-learning": {"/docs/windows-lite-automation/element-learning/": "Element Learning with Test Recorder"},
   "test-cases": {"/docs/windows-lite-automation/test-cases/": "Test Cases for Windows (Lite)" },
-  "copado-integration": {"/docs/continuous-integration/copado-integration/": "Copado CI/CD" }
+  "copado-integration": {"/docs/continuous-integration/copado-integration/": "Copado CI/CD" },
+  "features-and-scenarios": {"/docs/test-cases/manage/features-and-scenarios/": "Features & Scenarios" }
 }

src/pages/docs/reports/runs/custom-pdf-report.md

@@ -70,19 +70,23 @@ To generate reports, you need specific IDs depending on the level of detail you
 Run the Custom Report Generator with the required inputs to create a PDF report. This step converts your HTML template into a PDF based on your preferences. To execute the JAR file, follow these steps:
 
 1. Open Terminal or Command Prompt and navigate to the folder containing the JAR file.
-2. Run the following command, replacing the placeholders with your actual values:
-
-```bash
-java -jar custom_pdf_generator-0.0.1-SNAPSHOT.jar \
-  --config.apiKey=YOUR-API-KEY \
-  --config.plan.runId=YOUR-PLAN-RUN-ID \
-  --config.template.location=/path/to/your/template.html \
-  --config.pdf.directory=/path/to/save/report.pdf
-```
-
+2. Run the following command,<br>
+   - **For Mac**
+    ```bash
+    java -jar custom_pdf_generator-0.0.1-SNAPSHOT.jar \
+      --config.apiKey=YOUR-API-KEY \
+      --config.plan.runId=YOUR-PLAN-RUN-ID \
+      --config.template.location=/path/to/your/template.html \
+      --config.pdf.directory=/path/to/save/report.pdf
+    ```
+
+   - **For Windows**
+    ```bash
+    java -jar custom_pdf_generator-0.0.1-SNAPSHOT.jar --config.apiKey=<API-KEY> --config.plan.runId=97040 --config.template.location=/path/to/template.html --config.pdf.directory=/path/to/save/report.pdf
+    ```
 <br>
-Replace the placeholders with your actual values:
 
+Replace the placeholders with your actual values:
 - **YOUR-API-KEY**: Your API key for authentication with Testsigma.
 - **YOUR-PLAN-RUN-ID**: The run ID of your test plan.
 - **/path/to/your/template.html**: Path to your HTML template file.

src/pages/docs/test-cases/create-test-steps/overview.md

@@ -175,11 +175,22 @@ Here's a sample GIF demonstrating creating test steps manually for a Web Applica
 
 <br>
 
+<div style="background-color: #f8f9fa; padding: 20px; border-radius: 5px; border: 1px solid #dee2e6;">
+  <p style="font-size: 16px; color: #495057;">
+    <span style="color: #17a2b8; font-size: 20px;"></span>
+    <b>⚡ New:</b> You can now directly interact with mobile elements, and the recorder will automatically capture the action and convert it into the corresponding NLPs.
+  </p>
+</div>
+
+[[info | **NOTE**:]]
+| If direct recording doesn't work, revert to the old method and use the **TAP** button to record the element.
+
+<br>
+
 Here's a sample GIF demonstrating creating test steps using the recorder for a Web Application. 
 
    ![Record Test Steps for WebApps](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/RecordStepswappsWF.gif)
 
----
 
 ---
 

src/pages/docs/test-cases/manage/add-edit-delete.md

@@ -3,7 +3,7 @@ title: "Manage Test Cases"
 pagetitle: "Manage Test Cases"
 metadesc: "Effortlessly manage your test cases in Testsigma by seamlessly creating, editing, deleting, and recovering them. Streamline your test case management process, adapt to changing project needs, and ensure comprehensive test coverage."
 noindex: false
-order: 4.10
+order: 4.11
 page_id: "test-cases-testsigma"
 warning: false
 contextual_links:

src/pages/docs/test-cases/manage/features-and-scenarios.md

@@ -0,0 +1,116 @@
+---
+title: "Organizing Test Cases in Folders (✨ New)"
+pagetitle: "Organize Test Cases"
+metadesc: "Effortlessly organize test cases by features & scenarios, which provides a complete view of test coverage. The folder structure also simplifies the navigation."
+noindex: false
+order: 4.10
+page_id: "Folder Structure for Test Cases"
+warning: false
+contextual_links:
+- type: section
+  name: "Contents"
+- type: link
+  name: "Why Do We Have Folder Structure?"
+  url: "#why-do-we-have-folder-structure"
+- type: link
+  name: "Understanding Folder Structure"
+  url: "#understanding-folder-structure"
+- type: link
+  name: "Prerequisites"
+  url: "#prerequisites"
+- type: link
+  name: "Steps to Create Features"
+  url: "#steps-to-create-features"
+- type: link
+  name: "Steps to Create Scenarios"
+  url: "#steps-to-create-scenarios"
+---
+
+---
+
+With Testsigma's new folder structure, you can organize test cases by features, which provides a comprehensive view of test coverage. Each feature will have multiple scenarios, each with its respective test cases. This structure helps manage test cases based on specific scenarios and scenarios based on Features.
+
+---
+
+## **Why Do We Have Folder Structure?**
+Introducing folder structure for test cases simplifies finding and managing tests. In large test setups, organizing tests is very important as it plays a key role in quickly locating specific test cases. This will save you much time and increase productivity. This folder structure also prevents duplication of test cases, streamlining the workflow. A well-organized folder system helps teams easily find and create test cases, improving collaboration and reducing confusion.
+
+---
+
+## **Understanding Folder Structure**
+
+![Folders](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/FlowofFolders.png)
+
+Let's say you're creating test cases for an **Online Shopping App**. 
+
+- In this case, you can have **User Authentication**, **Product Search**, and **Shopping Cart** as **Features** under **Test Cases**. 
+
+- Each Feature can have multiple Scenarios like the examples mentioned below:
+
+📁 **Test Cases (Master Folder)**
+   - **User Authentication**
+       - Login
+       - Logout
+   - **Product Search**
+       - Search by Keyword
+       - Filter Results
+   - **Shopping Cart**
+       - Add to Cart
+       - Remove from Cart
+
+- The scenarios will have multiple test cases. In this cases, for **Login & Logout** scenarios, we can have the following test cases:
+    1. **Login**
+       - Login with valid credentials
+       - Login with invalid credentials & verify error message
+    2. **Logout**
+       - Verify successful logout
+       - Verify session expiration after logout
+
+---
+
+> ## **Prerequisites**
+>
+> Ensure you create a [Project](https://testsigma.com/docs/projects/overview/) before creating Test Cases in Testsigma. 
+
+---
+
+## **Steps to Create Features** 
+
+1. From the left navigation bar, go to **Create Tests > Test Cases**.
+
+2. Click **+** and choose **Add Feature** from the dropdown menu.
+
+3. In the **Add Feature** dialog, enter a name for the feature and click **Add**.
+
+4. The new feature will appear under the **Test Cases** section.
+
+Here's a quick GIF demonstrating steps to create features. 
+
+![Features](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/FeatureFlow.gif)
+
+---
+
+## **Steps to Create Scenarios**
+
+1. From the left navigation bar, go to **Create Tests > Test Cases**.
+
+2. Click **+** and choose **Add Scenario** from the dropdown menu.
+
+3. In the **Select Feature** dialog, choose the target feature and click **Next**. 
+
+4. In the dialog box that pops up, enter a name for the scenario and click **Create**.
+
+5. The new scenario will appear under **Test Cases > Feature**.
+
+6. Click **<** to minimize the **Features & Scenarios** section.
+
+Here's a quick GIF demonstrating steps to create scenarios. 
+
+![Scenarios](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/ScenarioFlow.gif)
+
+[[info | **NOTE**:]]
+| - You can click **List View** and perform list actions here. For more information, see [List Actions](https://testsigma.com/docs/test-cases/manage/list-actions/).
+| - This will also help you filter test cases with **Scenarios** while creating test suites.
+| ![Filter While adding Test Cases](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/projects/applications/FilterScenarios_TestSuites.png)
+
+---

src/pages/docs/windows-automation/introduction.md

@@ -52,6 +52,10 @@ You can also quickly jump to one of the following topics to learn about Windows
 - List of Technologies Supported in Testsigma
     - **Oracle**
     - **Java**
+    - **SAP GUI**
+    - **SAP UI5**
+    - **Insight**
+    - **Terminal Emulator**
 
 ---