Added unittests and docs for WorkerOpinion feature

docker/docker-compose.dev.vscode.yml

@@ -2,8 +2,6 @@
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
 
-version: "3"
-
 services:
   mephisto_dc_vscode:
     container_name: mephisto_dc_vscode

docker/docker-compose.dev.yml

@@ -2,8 +2,6 @@
 # This source code is licensed under the MIT license found in the
 # LICENSE file in the root directory of this source tree.
 
-version: "3"
-
 services:
   mephisto_dc:
     container_name: mephisto_dc

docs/web/docs/guides/how_to_use/review_app/overview.md

@@ -69,3 +69,9 @@ _Note that a custom view of Task results is included (at the bottom) only if you
 ![Task statistics](./screenshots/task_stats.png)
 <br/>
 <br/>
+
+### Task worker opinions
+
+![Task statistics](./screenshots/task_worker_opinions.png)
+<br/>
+<br/>

docs/web/docs/guides/how_to_use/worker_experience/mephisto-task-addons.md

@@ -0,0 +1,50 @@
+---
+
+# Copyright (c) Meta Platforms and its affiliates.
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+sidebar_position: 1
+---
+
+# Mephisto Task Addons
+
+## Overview
+
+The `mephisto-task-addons` package provides:
+- `WorkerOpinion` widget: collect workers' feedback for each completed unit
+
+## Usage
+
+1. Add `mephisto-task-addons` library to your webpack config:
+```js
+// Specifies location of your packages (e.g. `../../dir`)
+var PATH_TO_PACKAGES = "<path>"
+
+module.exports = {
+  ...
+  resolve: {
+    alias: {
+      ...
+      "mephisto-task-addons": path.resolve(
+        __dirname,
+        `${PATH_TO_PACKAGES}/packages/mephisto-task-addons`
+      ),
+    }
+  }
+};
+```
+
+2. Import desired widgets from `mephisto-task-addons` in your code like so:
+
+```jsx
+import { WorkerOpinion } from "mephisto-task-addons";
+...
+<WorkerOpinion
+  maxTextLength={500}
+  questions={[
+    "Was this task hard?",
+    "Is this a good example?",
+  ]}
+/>
+```

docs/web/docs/guides/how_to_use/worker_experience/worker_opinion.md

@@ -0,0 +1,78 @@
+---
+
+# Copyright (c) Meta Platforms and its affiliates.
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+sidebar_position: 2
+---
+
+# WorkerOpinion widget
+
+Workers can leave their feedback about a Task if you add a `WorkerOpinion` feature to it.
+
+WorkerOpinion widget currently may contain a set of textarea form fields, and a multi-file attachment form field.
+
+
+## How to enable `WorkerOpinion`
+
+1. Add `mephisto-task-addons` library to your webpack config
+2. Import `WorkerOpinion` component to your Task's React application code and define questions.
+
+### 1. Webpack config
+
+```js
+// Specifies location of your packages (e.g. `../../dir`)
+var PATH_TO_PACKAGES = "<path>"
+
+module.exports = {
+  ...
+  resolve: {
+    alias: {
+      ...
+      "mephisto-task-addons": path.resolve(
+        __dirname,
+        `${PATH_TO_PACKAGES}/packages/mephisto-task-addons`
+      ),
+    }
+  }
+};
+```
+
+### 2. `WorkerOpinion` component
+
+```jsx
+import { WorkerOpinion } from "mephisto-task-addons";
+...
+return(
+  <div ...>
+    <WorkerOpinion
+      maxTextLength={500}
+      questions={[
+        "Was this task hard?",
+        "Is this a good example?",
+      ]}
+    />
+  </div>
+)
+```
+
+Supported properties for `WorkerOpinion` component:
+
+- `handleSubmit` (optional) - your custom callback that will run on opinion submit
+- `maxTextLength` (optional) - max amount of characters for all textarea fields
+- `questions` (optional, array of strings) - list of questions for the worker, where each response is a textarea field
+- `required` (optional) - if `false`, adds `" (optional)"` suffix to question text (default: `false`)
+- `textAreaWidth` (optional) - width of all textarea fields (default: `100%`)
+- `title` (optional) - title of the WorkerOpinion widget. Default: `Your Feedback`
+
+Here's how `WorkerOpinion` component looks like:
+
+![Worker Opinion](./screenshots/worker_opinion_widget.png)
+
+
+## How `WorkerOpinion` works
+
+1. After completing each unit, workers can submit an opinion about the completed unit.
+2. **Once the task is shut down**, you can review all collected opinions for the task in TaskReview app.
+3. When reviewing units in TaskReview app, you will see an extra accordion section "Worker Opinion" if a worker submitted their opinion.