build your first basic workflow experimentation #3994
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
jsundai
changed the title
There was a problem hiding this comment.
Just curious why these logos are being added. It looks like all of them are already here.
|
A couple of general questions.
|
| Most applications require multiple coordinated steps - processing payments, sending emails, updating databases. | ||
| This tutorial uses money transfers to demonstrate how Temporal ensures these multi-step processes complete reliably, resuming exactly where they left off even after any failure. | ||
| <div style={{textAlign: 'center', margin: '2rem 0'}}> | ||
| <img src="/img/moneytransfer/money-withdrawal.png" alt="Money Transfer Application Flow" style={{maxWidth: '100%', height: 'auto'}} /> |
There was a problem hiding this comment.
This image is pretty hard to read in light mode.
docs/build-your-first-basic-workflow/build-your-first-workflow.mdx
Outdated
Show resolved
Hide resolved
|
|
||
| <RetryPolicyComparison /> | ||
|
|
||
| :::important This is a Simplified Example |
There was a problem hiding this comment.
Minor nit: should this be a warning just to highlight this? Totally fine if not!
docs/build-your-first-basic-workflow/build-your-first-workflow.mdx
Outdated
Show resolved
Hide resolved
docs/build-your-first-basic-workflow/build-your-first-workflow.mdx
Outdated
Show resolved
Hide resolved
| <CallToAction | ||
| href="http://localhost:8233" | ||
| buttonText="Open the Temporal UI " | ||
| description="View the state of the Workflow with the Temporal Web UI" |
There was a problem hiding this comment.
Should we have something that says this is running locally?
| - The `withdraw()` Activity completes successfully | ||
| - The `deposit()` Activity fails and retries automatically | ||
|
|
||
| <AnimatedTerminal |
There was a problem hiding this comment.
I really like this! The only thing is that it makes the page jump when there are new lines in the terminal.
Screen.Recording.2025-12-01.at.11.59.57.mov
|
|
||
| Before starting this tutorial: | ||
|
|
||
| - **Set up a local development environment** for developing Temporal applications |
There was a problem hiding this comment.
I feel like the prerequisites are a little unclear to those who are new to our site. I know that if users go through the quick starts if they are set, but if I'm a new user, it's not clear if I am supposed to do the setup AND the quickstarts.
If we don't want to create a separate environment setup page, then we should just remove the two bullets and just tell them to do the quickstarts as a prerequisite.
docs/build-your-first-basic-workflow/build-your-first-workflow.mdx
Outdated
Show resolved
Hide resolved
| id: build-your-first-workflow | ||
| title: Build Your First Workflow | ||
| sidebar_label: "Part 1: Build Your First Workflow" | ||
| hide_table_of_contents: true |
There was a problem hiding this comment.
i know that the layout is well designed and we could use the vertical space, but i still think this is a long enough tutorial that it'd be beneficial to have the TOC. It's easier for users to make sense of whey are doing in the context of the whole project. Right now, they can't see more than the H2 heading they are in.
brianmacdonald-temporal
left a comment
brianmacdonald-temporal
left a comment
There was a problem hiding this comment.
I feel like we could use some text explanation for each of the code blocks. Maybe Point out specifically what the workflow is calling, and how that relates to the activities, and point out the Retry Policy details.
| <SetupSteps> | ||
|
|
||
| <SetupStep code={ | ||
| <SdkTabs> |
There was a problem hiding this comment.
I think you're missing languageOrder={TUTORIAL_LANGUAGE_ORDER} here, which threw me off.
|
|
||
| with workflow.unsafe.imports_passed_through(): | ||
| from activities import BankingActivities | ||
| from shared import PaymentDetails |
There was a problem hiding this comment.
PaymentDetails isn't defined in shared.py that I can see.
….mdx Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>
….mdx Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>
…ated and added light and dark mode reimburse diagram, max width 60
What does this PR do?
https://temporal-documentation-git-tutorial-layout-money-transfe-0fc0c4.preview.thundergun.io/build-your-first-basic-workflow/build-your-first-workflow
Notes to reviewers
files changed include new components for interaction and sdk boxed logos
wip (TODO: make light mode friendly)
aiming for: concise + engaging, dev-to-dev tone, consistent interactions, progressive disclosure.
next iteration: can include sdk box logos