Skip to content

[Workflows] Introductory material and foundational concepts#4713

Merged
nastasha-solomon merged 33 commits into
workflows-9.3from
workflows-intro-material
Jan 27, 2026
Merged

[Workflows] Introductory material and foundational concepts#4713
nastasha-solomon merged 33 commits into
workflows-9.3from
workflows-intro-material

Conversation

@nastasha-solomon

@nastasha-solomon nastasha-solomon commented Jan 20, 2026

Copy link
Copy Markdown
Member

Summary

Fixes #4650: Adds introductory material, including an overview of workflows and a tutorial for getting started.

Previews

To find these pages in the left nav, go to Elastic Docs > Explore and analyze > Workflows

NOTE:

  • These previews are static deployments generated via netlify – they won't get auto-updated when new commits are pushed to the PR.
  • These previews are deployments of the Explore and analyze section – pages outside of this section are not available to preview.

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No

Tool(s) and model(s) used:
Cursor, claude-4.5-opus-high

@nastasha-solomon nastasha-solomon self-assigned this Jan 20, 2026
@github-actions

github-actions Bot commented Jan 20, 2026

Copy link
Copy Markdown
Contributor

Vale Linting Results

Summary: 3 suggestions found

💡 Suggestions (3)
File Line Rule Message
explore-analyze/workflows.md 23 Elastic.WordChoice Consider using 'efficient, basic' instead of 'simple', unless the term is in the UI.
explore-analyze/workflows.md 106 Elastic.Repetition "to" is repeated.
explore-analyze/workflows/get-started.md 157 Elastic.WordChoice Consider using 'refer to (if it's a document), view (if it's a UI element)' instead of 'see', unless the term is in the UI.

The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

@nastasha-solomon nastasha-solomon marked this pull request as ready for review January 20, 2026 20:28
@nastasha-solomon nastasha-solomon requested review from a team as code owners January 20, 2026 20:28
Comment thread explore-analyze/workflows/get-started.md
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md
Comment thread explore-analyze/workflows/get-started.md
Comment thread explore-analyze/workflows/get-started.md
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows/get-started.md
@jamesspi

Copy link
Copy Markdown

@nastasha-solomon In the Pre-requisites section, we should add a note on RBAC. They will need to appropriate permissions to leverage workflows.

@vishaangelova vishaangelova left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is great stuff! The structure is flowing well, and the content is easy to understand! ✨

I left some comments and suggestions for your consideration — feel free to accept or ignore as you see fit :)

Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
Comment thread explore-analyze/workflows/get-started.md Outdated
nastasha-solomon and others added 4 commits January 23, 2026 10:21
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
nastasha-solomon and others added 12 commits January 23, 2026 10:23
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Co-authored-by: Visha Angelova <91186315+vishaangelova@users.noreply.github.com>
Comment thread explore-analyze/workflows/get-started.md
name: { type: text }
category: { type: keyword }
description: { type: text }
- name: bulk_index_park_data

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jamesspi @tinnytintin10 wondering if this step needs to be updated as per the recommendation here.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I left a note to @talboren that it's not typical that we would backport a breaking change in a patch release. I would say leave as is for 9.3

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is elastic/workflows#3 fixing this issue for 9.3.1? If so, would we need to update the examples as per what's described in elastic/workflows#2?

@vishaangelova vishaangelova left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! 🚀

@nastasha-solomon

Copy link
Copy Markdown
Member Author

Additional changes to this content can be made in #4758.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants