Merge pull request #332 from testsigmahq/dev

Dev to main [27 Nov]

.github/workflows/cd.yml

@@ -7,6 +7,8 @@ jobs:
   Deploy:
     runs-on: ubuntu-latest
     steps:
+      - name: Update package information with default mirror
+        run: sudo sed -i 's|mirror+file:/etc/apt/apt-mirrors.txt|http://archive.ubuntu.com/ubuntu|' /etc/apt/sources.list && sudo apt-get update
       - name: Install libvips
         run: sudo apt-get install libvips
       - uses: actions/checkout@v2
@@ -51,7 +53,7 @@ jobs:
           TYPESENSE_COLLECTION: ${{ secrets.TYPESENSE_COLLECTION }}
           TYPESENSE_API_KEY: ${{ secrets.TYPESENSE_API_KEY }}
           TYPESENSE_SEARCH_API_KEY: ${{ secrets.TYPESENSE_SEARCH_API_KEY }}
-      
+
       - name: Start Gatsby server
         run: npm run develop &
         env:

.github/workflows/ci.yml

@@ -1,11 +1,13 @@
 name: 'CI'
 on:
   pull_request:
-    types: [ opened, synchronize, reopened ]
+    types: [opened, synchronize, reopened]
 jobs:
   CI:
     runs-on: ubuntu-latest
     steps:
+      - name: Update package information with default mirror
+        run: sudo sed -i 's|mirror+file:/etc/apt/apt-mirrors.txt|http://archive.ubuntu.com/ubuntu|' /etc/apt/sources.list && sudo apt-get update
       - name: Install libvips
         run: sudo apt-get install libvips
       - uses: actions/checkout@v2

.github/workflows/staging-cd.yml

@@ -7,6 +7,8 @@ jobs:
   StagingDeploy:
     runs-on: ubuntu-latest
     steps:
+      - name: Update package information with default mirror
+        run: sudo sed -i 's|mirror+file:/etc/apt/apt-mirrors.txt|http://archive.ubuntu.com/ubuntu|' /etc/apt/sources.list && sudo apt-get update
       - name: Install libvips
         run: sudo apt-get install libvips
       - uses: actions/checkout@v2
@@ -38,7 +40,7 @@ jobs:
           echo TYPESENSE_SEARCH_API_KEY=${{ secrets.WEBSITE_STAGING_TYPESENSE_SEARCH_API_KEY }} >> .env
           cat .env
       - name: Set environment
-        run : sed -i 's/localhost/website.testsigma.com/g' src/environment.ts
+        run: sed -i 's/localhost/website.testsigma.com/g' src/environment.ts
       - name: Build
         run: |
           PREFIX_PATHS=true npm run build && npm run deploy

src/left-nav-title.json

@@ -574,5 +574,14 @@
   },
   "desktop-windows":{
     "/docs/projects/setup/desktop-windows/": "Desktop Windows"
+  },
+  "actions-and-options-recorder":{
+  "/docs/test-cases/create-test-steps/actions-and-options-recorder/": "Actions & Options (Recorder)"
+  },
+  "actions-and-options-manual":{
+    "/docs/test-cases/create-test-steps/actions-and-options-manual/": "Actions & Options (Manual)"
+  },
+  "multiple-webviews":{
+    "/docs/test-cases/create-test-steps/actions-and-options-recorder/multiple-webviews/": "Tests for Multiple WebViews"
   }
 }

src/pages/docs/continuous-integration/aws-devops.md

@@ -1,6 +1,6 @@
 ---
 title: " Integrate Testsigma with AWS DevOps"
-metadecs: "How to integrate Testsigma with AWS DevOps" 
+metadecs: "This article discusses step-by-step instructions for integrating Testsigma application with AWS DevOps | Learn how to integrate AWS DevOps with Testsigma Application" 
 order: 12.15
 page_id: "Integrate Testsigma with AWS DevOps"
 warning: false
@@ -16,13 +16,16 @@ contextual_links:
 
 AWS services that are used as a part of CI/CD pipeline are:
 
-**CodeCommit:** AWS CodeCommit is a version control service that enables you to privately store and manage Git repositories in the AWS cloud.
-**CodeBuild:** CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy.
+**CodeCommit:** AWS CodeCommit is a version control service that enables you to privately store and manage Git repositories in the AWS cloud.<br>
+
+**CodeBuild:** CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy.<br>
+
 **CodeDeploy:** AWS CodeDeploy is a deployment service that enables developers to automate the deployment of applications to instances and to update the applications as required.
 
 
 ---
-##**AWS DevOps integration methods:**
+
+## **AWS DevOps integration methods:**
 
 Below are the 2 methods to integrate and trigger Testsigma tests via AWS DevOps:
 
@@ -114,3 +117,4 @@ That's all we need to automate Test Execution when a successful build is trigger
 
 
 
+---

src/pages/docs/continuous-integration/github-cicd.md

@@ -1,6 +1,6 @@
 ---
 title: "Integrate Testsigma with Github"
-metadecs: "This document describes detailed step-by-step instructions for integrating Testsigma with Github | Learn how to integrate Github with Testsigma" 
+metadecs: "This article discusses step-by-step instructions for integrating Testsigma application with Github | Learn how to integrate Github with Testsigma Application" 
 order: 12.21
 page_id: "github-cicd"
 warning: false
@@ -19,13 +19,15 @@ contextual_links:
 When you want to automate, customize, and, execute your software development workflows right in your github repository, you need to use github actions. In this document, we will discuss how to integrate Github with Testsigma for CI/CD purposes.
 
 ---
+
 ## **Pre-requisites:**
 You should already know:
  1. The basics of github actions. If not, please refer here: [Quickstart with github actions](https://docs.github.com/en/actions/quickstart)
  2. [How to generate an API key from Settings.](https://testsigma.com/docs/configuration/api-keys/)
  2. [How to get Test Plan ID from an existing Test Plan.](https://testsigma.com/docs/continuous-integration/get-test-plan-details/)
 
 ---
+
 ## **For Github CICD Integration:**
 
 To start with Github Actions, create a .github/workflows directory in your repository on GitHub if this directory does not already exist.

src/pages/docs/elements/android-apps/capture-single-element.md

@@ -17,7 +17,12 @@ contextual_links:
 - type: link
   name: "How to create one element at a time using the Testsigma mobile inspector for an android project in Testsigma"
   url: "#how-to-create-one-element-at-a-time-using-the-testsigma-mobile-inspector-for-an-android-project-in-testsigma"
-
+- type: link
+  name: "Updating an Element"
+  url: "#updating-an-element"
+- type: link
+  name: "Reusing Elements Recorded"
+  url: "#reusing-elements-recorded"
 ---
 
 
@@ -61,3 +66,75 @@ In an Android project in Testsigma, you can selectively capture elements one at
 
 You can also [capture multiple elements at once via mobile test recorder](https://testsigma.com/docs/elements/android-apps/record-multiple-elements/).
 
+
+## **Updating an Element**
+
+ 1. Create a Test Case using Testsigma’s test Recorder in your Android Project. 
+ 2. On the Recorder UI, hover over the step that has the element you want to edit. The elements appear in green on the Testsigma test Recorder UI
+
+![Highlighted example elements in Testsigma Recorder](https://docs.testsigma.com/images/update-elements/highlighted-example-elements-android-testsigma-Recorder.png)
+
+
+ 3. Click on the ‘More Details’ button corresponding to the step that you want to edit. The button corresponding to the step is highlighted in the screenshot below:
+
+![more details button for a test step in an Android Project in Testsigma while using the Recorder](https://docs.testsigma.com/images/update-elements/more-details-button-for-a-test-step-android-testsigma-Recorder.png)
+
+ 4. Click on ‘More details’ button:
+
+![test step details for an Android test case on Testsigma Recorder UI](https://docs.testsigma.com/images/update-elements/test-step-details-testsigma-Recorder-android.png)
+
+ 5. Click on the edit button corresponding to the element on the Test Step Details:
+
+![edit element button on test step details section for testsigma Recorder for android](https://docs.testsigma.com/images/update-elements/edit-element-button-test-step-details-testsigma-Recorder-android.png)
+
+ 
+
+![edit element UI from test step details section on the Recorder UI for an android project in Testsigma](https://docs.testsigma.com/images/update-elements/edit-element-ui-from-test-step-details-Recorder-android-testsigma.png)
+
+ 
+
+Here are the fields that appear on the ‘Edit Element’ window:
+
+ * **Name**: Text input field, you can edit the name of the Element here
+ * **Screen Name**: This is an editable field, you can edit the screen name for the Element here.
+ * **Element Type**: This is a drop-down field that has values:
+   1. Xpath
+   2. ID
+   3. Name
+   4. Class Name
+   5. Accessibility ID
+
+You can select any of these options for element type.
+ * **Enter Value**: Here, the value should correspond to the element type selected. This is also an editable field.
+
+
+6. Click on the ‘Update’ button to finalize the changes.
+
+---
+
+
+## **Reusing Elements Recorded**
+
+ 1. Create a test case in which you will be reusing your pre-recorded elements.
+ 2. Start recording test steps for the test case.
+ 3. Manually add a test step where you want to reuse elements:
+
+
+![example of test steps that contain elements in an android project in Testsigma](https://docs.testsigma.com/images/reuse-elements/test-steps-that-contain-elements-testsigma-android.png)
+
+ 
+
+Alternatively, you can record a test step that uses an element. Given below is an example of test steps as they appear on Recorder UI. The text in green is an element.
+
+![example of recorded test steps that contain elements for an android project in Testsigma](https://docs.testsigma.com/images/reuse-elements/recorded-test-steps-that-contain-element-testsigma-android.png)
+
+ 4. Hover on the test step that you want to edit and click on the corresponding edit button. 
+ 5. Click on the green text that represents ‘element’. The ‘Elements’ section appears on the test Recorder UI, listing all pre-recorded elements in the project:
+
+![Elements screen to reuse elements in Testsigma Recorder for an android project](https://docs.testsigma.com/images/reuse-elements/Element-screen-reuse-elements-testsigma-Recorder-android.png)
+
+ 6. Start typing the name of the element that you want to reuse, the elements will be filtered by name. You can search the elements by name or by Screen name.
+ 7. From the filtered results, you can click on the element that you want to use, and the element text in your test step will be replaced by the chosen element.
+ 8. Click on ‘Update’ button corresponding to the test step on the Testsigma test Recorder UI to finalize the change.
+
+---

src/pages/docs/elements/android-apps/create-manually.md

@@ -1,6 +1,6 @@
 ---
 title: "Create Elements [Manually]"
-metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a android apps in Testsigma."
+metadesc: "Element path plays an important role in dynamic websites. Learn how to create elements manually for a android apps in Testsigma application"
 noindex: false
 order: 6.34
 page_id: "Create Elements [Manually]"
@@ -12,34 +12,35 @@ contextual_links:
   name: "Introduction"
   url: "#introduction"
 - type: link
-  name: "Pre-requisites"
-  url: "#pre-requisites"
+  name: "Prerequisites"
+  url: "#prerequisites"
 - type: link
-  name: "How to create elements manually for an android project in Testsigma"
-  url: "#how-to-create-elements-manually-for-an-android-project-in-testsigma"
-
----
-
+  name: "Creating Elements"
+  url: "#creating-elements"
+- type: link
+  name: "Creating Element While Adding Test Steps"
+  url: "#creating-element-while-adding-test-steps"
+- type: link
+  name: "Updating an Element"
+  url: "#updating-an-element"
+- type: link
+  name: "Updating Multiple Elements"
+  url: "#updating-multiple-elements"
 ---
-##**Introduction**
-In this document, we will discuss how to create elements manually for your android project in Testsigma i.e. without the use of a mobile test recorder.
 
-<br>
 
 ---
-##**Pre-requisites**
-1. You should have an android project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).
-
-<br>
 
-**Navigation**
+In this document, we will discuss how to create elements manually for your android project in Testsigma i.e. without the use of a mobile test recorder.
 
-**Test Development > Elements**
+---
 
-<br>
+## **Prerequisites**
+- You should have an android project in Testsigma. See [creating a project](https://testsigma.com/docs/projects/overview/).
 
 ---
-##**How to create elements manually for an android project in Testsigma**
+
+## **Creating Elements**
 1. Go to your android project, then go to Test Development > Elements.
 2. On the ‘All Elements’ page that appears, click on the create button on the top right:
 
@@ -66,3 +67,87 @@ Here are the fields that you will see:<br>
 <br>
 
 6. Once you have added all the details, click on the ‘Create’ button and the element you created will be added to the project.
+
+
+---
+
+## **Creating Element While Adding Test Steps**
+ 1. Create a test case or go to a pre-existing test case. 
+ 2. Add a test step to the test case that contains an element. The language for the test step should contain an element. Some examples of such steps for an android application are shown in the screenshot below:
+
+![the various Action test steps for android application in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-various-Actions-test-steps-android-testsigma.png)
+
+ 3.  Let’s say we add a step ‘Tap on element’ to our test case:
+
+![Element specific test step test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-element-specific-test-step-test-case-page-android-testsigma.png)
+
+ 4. On the step, click on the green text ‘element’, a layover will appear containing the elements in the project like this:
+
+![Elements layover over a test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-elements-layover-over-test-case-page-android-testsigma.png)
+
+ 5. Here, to create an element that is not in the list, start typing a new name for the element, the option “NEW” will appear like this:
+
+![add new element with a new name on test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/add-new-element-with--new-name-test-case-page-android-testsigma.png)
+
+ 6. Click on the ‘NEW’ button highlighted in the last step. ‘Create Element’ form will open up as shown in the screenshot below:
+
+![create element form on test case page for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/the-create-element-form-on-test-case-page-android-testsigma.png)
+
+ 7. Create the element either manually or via element Test recorder. In this document, we will cover how to create elements ‘manually’. You can also [capture elements via Test recorder](https://testsigma.com/docs/elements/android-apps/capture-single-element/). For now, select the radio button ‘Manually’.
+
+ 8. You will see the form options as shown in the screenshot below:
+
+![create element form in Testsigma for an android project with Manually radio button selected ](https://docs.testsigma.com/images/create-a-new-element/create-element-manually-android-testsigma.png)
+
+&emsp;
+
+Here are the fields that you will see:
+ 1. **Name**: Enter the name you want to give your element.
+ 2. **Screen Name**: Mention the screen that your element resides on.
+ 3. **Element Type**: There are 5 types of identifier types supported in Testsigma. This field is a drop-down list and you can select any one of them: XPATH, ID, Name, Class Name, or Accessibility ID
+ 4. **Enter Value**: Enter the value here that is in correspondence with the Identifier Type you selected
+
+![element type dropdown values on the create element form for android project in Testsigma](https://docs.testsigma.com/images/create-a-new-element/element-type-dropdown-value-create-an-element-android-testsigma.png)
+
+ 9. Once you have added all the details, click on the ‘Create’ button. The green text ‘element’ will be replaced in the test step you were creating. 
+
+    You can now continue adding the test step for your android project.
+
+---
+
+## **Updating an Element**
+
+ 1. Select your project and then navigate to **Test Development > Elements**
+ 2. **All Elements** page will appear. This contains all the elements that you have created for the selected android project, like this:
+
+![all elements page to update elements for android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/all-elements-page-update-elements-android-testsigma.png)
+
+ 3. Scroll or filter to find the element you want to update.
+ 4. Hover over the element and click on the **Edit** that appears. The button is also highlighted in the screenshot below:
+
+![edit button for an element in all elements page for android project in Testsigma](https://docs.testsigma.com/images/update-elements/edit-button-for-an-element-in-all-elements-android-testsigma.png)
+
+ 5. The Edit Element layover will appear:
+
+![edit element page to update elements for android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/edit-element-page-update-elements-android-testsigma.png)
+
+There is a radio button that lets you choose between **Manually** or **Element Inspector**. When **Manually** is selected, you can make the changes you need to make in this element on the form and click on **Update** to finalize the changes. For the Test recorder approach, see how to [update elements using Test recorder](https://testsigma.com/docs/test-cases/create-steps-recorder/android-apps/update-elements/).
+
+---
+
+## **Updating Multiple Elements**
+
+ 1. Select your android project and then navigate to **Test Development > Elements**
+ 2. On the top right, there is an option to export the elements in excel format:
+
+![export button on all elements page to update elements for an android project Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/export-button-all-elements-page-update-elements-android-testsigma.png)
+
+ 3. In the excel sheet, update the required fields for the required elements.
+ 4. Click on **Import**. Select the excel sheet you updated in step 3 for import.
+
+![import button on all elements page to update elements for an android project in Testsigma](https://s3.amazonaws.com/static-docs.testsigma.com/new_images/test-cases/create-steps-nl/android-apps/update-elements/import-button-all-elements-page-update-elements-android-testsigma.png)
+
+With import, the edits done in step 3 will be visible in the corresponding elements in your android project in Testsigma.
+
+
+---