evergreen-ci · SupaJoon · Oct 7, 2024 · Sep 26, 2024 · Oct 7, 2024 · Oct 7, 2024
diff --git a/docs/UI/Parsley-Sectioning.md b/docs/UI/Parsley-Sectioning.md
@@ -0,0 +1,38 @@
+# Parsley Sectioning
+
+## Overview
+Parsley sectioning is toggleable from the "Log Viewing" tab of the "Parsley Settings" menu and is available to task logs only. Toggling the feature will render your task log into expandable sections split up by function and command.
+
+## Feature details
+
+### Feature components
+At the top of the log viewer, two buttons are available to "Open all sections" and "Close all sections". Clicking these buttons will expand and collapse every function and command section in the log file.
+
+![Toggle All Sections](../images/toggle_all_sections.png)
+
+There are also toggles available on function rows, "Open Subsections" and "Close Subsections", to expand and collapse all commands that belong to the function.
+
+![Toggle Subsections](../images/toggle_subsections.png)
+
+Clicking on the caret will also open and close a single command or function section.
+
+![Toggle Single Section](../images/section_toggle.png)
-Clicking on the caret will also open and close a single command or function section.
-
-![Toggle Single Section](../images/section_toggle.png)
+The caret on the left-hand side can also be used to open or close a single command or function section.
-Clicking on the caret will also open and close a single command or function section.
-
-![Toggle Single Section](../images/section_toggle.png)
+The caret on the left-hand side can also be used to open or close a single command or function section.
+
+### Section status
+A function containing a failing command is marked with a failing status icon whereas as passing function is marked with a passing icon.
+
+![Passing Function](../images/passing_function.png)
+
+![Failing Function](../images/failing_function.png)
+
+### Jump to Failing Line
+Jump to Failing Line is a separate feature that works synergistically with Sectioning. When enabled with Sectioning, Parsley will open the failing command section and scroll to the failing line during initial load.
+
+### Searching
+Sections that contain a search result will open. Iterating over search results will open the section if it's closed.
+
+### Filtering
+Sections will temporarily go away when filters are applied and come back when filters are removed.
-Sections will temporarily go away when filters are applied and come back when filters are removed.
+Sectioning cannot be used in conjunction with filters. Sections will not render when filters are applied, but will reappear when all filters are removed.
-Sections will temporarily go away when filters are applied and come back when filters are removed.
+Sectioning cannot be used in conjunction with filters. Sections will not render when filters are applied, but will reappear when all filters are removed.
+
+### Shareline
+When a link with a share line is opened, Parsley will open the section that contains the share line and scroll to the line. The failing line section will still open but Parsley will scroll to the share line instead.
-### Shareline
-When a link with a share line is opened, Parsley will open the section that contains the share line and scroll to the line. The failing line section will still open but Parsley will scroll to the share line instead.
+### Share Line
+Share line takes precedence over failing line. When a link with a share line is opened, Parsley will open the section that contains the share line and scroll to the line. The failing line section will still be open and accessible via the bookmarks bar.
-### Shareline
-When a link with a share line is opened, Parsley will open the section that contains the share line and scroll to the line. The failing line section will still open but Parsley will scroll to the share line instead.
+### Share Line
+Share line takes precedence over failing line. When a link with a share line is opened, Parsley will open the section that contains the share line and scroll to the line. The failing line section will still be open and accessible via the bookmarks bar.
diff --git a/docs/images/failing_function.png b/docs/images/failing_function.png
diff --git a/docs/images/passing_function.png b/docs/images/passing_function.png
diff --git a/docs/images/section_toggle.png b/docs/images/section_toggle.png
diff --git a/docs/images/toggle_all_sections.png b/docs/images/toggle_all_sections.png
diff --git a/docs/images/toggle_subsections.png b/docs/images/toggle_subsections.png