Skip to content

Simple, hello world guide to get started quickly#8575

Open
bojtospeter wants to merge 6 commits intomainfrom
get-started-hello-world
Open

Simple, hello world guide to get started quickly#8575
bojtospeter wants to merge 6 commits intomainfrom
get-started-hello-world

Conversation

@bojtospeter
Copy link
Copy Markdown
Contributor

Description

Create a getting started guide, even simpler than the existing service worker one. Reuse the existing example from the same repo.

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support. (add bug or support label)
  • This is already available but undocumented and should be released within a week. (add available & undocumented label)
  • This is on a specific schedule and the assignee will coordinate a release with the Documentation team. (create draft PR and/or add hold label)
  • This is part of a scheduled alpha or minor. (add alpha or minor label)
  • There is no urgency with this change (add low prio label)

PR Checklist

  • My changes are for an upcoming minor release and are in the /docs directory (version 8.9).
  • My changes are for an already released minor and are in a /versioned_docs directory.

@github-actions
Copy link
Copy Markdown
Contributor

👋 🤖 🤔 Hello, @bojtospeter! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.8/.

  • docs/guides/getting-started-hello-world.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@bojtospeter
Copy link
Copy Markdown
Contributor Author

@copilot would you please check this PR? I'm aiming for friendly, easy to understand content for new users.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a new “hello world” getting started guide to help users deploy and run a first BPMN process quickly, and exposes it in the Guides sidebar.

Changes:

  • Added a new guide page: “Deploy and run your first BPMN process with Camunda 8” (no-code Rocket Launch example).
  • Linked the new guide into the “Get started” section of the Guides sidebar.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
sidebars.js Adds the new getting-started guide to the Guides → Get started navigation.
docs/guides/getting-started-hello-world.md Introduces a new beginner “hello world” guide for deploying/running a BPMN + DMN example with Camunda 8 Run.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 13, 2026

@copilot would you please check this PR? I'm aiming for friendly, easy to understand content for new users.

I've reviewed the content with new users in mind and made a few targeted improvements in commit 964aec2:

  • Opening: Added a reassurance for users who are new to Camunda or BPMN ("don't worry — you don't need any background knowledge").
  • What you'll learn: Added a note before the table that users don't need prior knowledge of these concepts.
  • Prerequisites: Added brief context explaining why JDK is needed.
  • Step 5 & 6: Clarified where the "Rocket" icon lives ("in the bottom toolbar") and made the Deploy button explicit in both deploy steps. Changed "Go back to" → "Switch back to" for consistent, natural flow.
  • How it works: Added a note that users don't need to read or edit FEEL expressions to complete the guide — it's an optional reference.
  • Complete!: Added a congratulations message to give new users a sense of achievement.

The overall structure and technical content are unchanged — these are tone and clarity improvements aimed at reducing friction for first-time users.

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@mesellings mesellings requested review from mesellings and removed request for a team April 14, 2026 11:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: 👀 In Review

Development

Successfully merging this pull request may close these issues.

3 participants