Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add Node task queues and workers docs #495

Merged
merged 8 commits into from
Jul 12, 2021

Conversation

vkarpov15
Copy link
Contributor

What does this PR do?

Add Task Queues and Workers sections to Node docs to line up with other languages.

Notes to reviewers

@vkarpov15 vkarpov15 self-assigned this Jun 25, 2021
Copy link
Member

@bergundy bergundy left a comment

Choose a reason for hiding this comment

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

Thanks,
Those are great additions.


import SharedTaskQueuesBasic from '../shared/task-queues-basic.md'

<SharedTaskQueuesBasic
Copy link
Member

Choose a reason for hiding this comment

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

Not strictly related to this PR but the first paragraph is inaccurate:

From a high level, we can say that a Task Queue is exactly what the name suggests. It is a "first-in-first-out" queue for Tasks, where a Task is the context needed to execute a chunk of code that alters the "state" of a Workflow.

What about activity task queues? Those should be mentioned here as well IMHO.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This one is exactly as written in the Go and Java docs, so I think we should discuss this issue separately. I agree that it's worth mentioning that Task Queues store both Tasks and Activities.

Copy link
Member

Choose a reason for hiding this comment

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

We are working on more precise, reusable term definitions in the Jargon Mesh project.
LMK if you want to those meetings -

docs/node/task-queues.md Outdated Show resolved Hide resolved
docs/node/task-queues.md Outdated Show resolved Hide resolved
docs/node/task-queues.md Outdated Show resolved Hide resolved
docs/node/workers.md Outdated Show resolved Hide resolved
docs/node/workers.md Outdated Show resolved Hide resolved
docs/node/workers.md Outdated Show resolved Hide resolved
docs/node/workers.md Outdated Show resolved Hide resolved
docs/node/workers.md Show resolved Hide resolved
@netlify
Copy link

netlify bot commented Jul 12, 2021

✔️ Deploy Preview for mystifying-fermi-1bc096 ready!

🔨 Explore the source changes: cc43f9a

🔍 Inspect the deploy log: https://app.netlify.com/sites/mystifying-fermi-1bc096/deploys/60ecadeddb486700079b19ae

😎 Browse the preview: https://deploy-preview-495--mystifying-fermi-1bc096.netlify.app

Comment on lines +21 to +29
1. When starting a Workflow, you must pass the `taskQueue` option to the [Connection's `workflow()` method](https://nodejs.temporal.io/api/classes/client.connection#workflow).

```typescript
const workflow = connection.workflow("my-workflow", {
taskQueue: "my-task-queue",
});

const result = await workflow.start();
```
Copy link
Member

Choose a reason for hiding this comment

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

This is now outdated with the recent changes to the client package.
Let's remember to update this doc before we release the new package.

@netlify
Copy link

netlify bot commented Jul 12, 2021

✔️ Deploy Preview for mystifying-fermi-1bc096 ready!

🔨 Explore the source changes: 6759d02

🔍 Inspect the deploy log: https://app.netlify.com/sites/mystifying-fermi-1bc096/deploys/60ecae10cb2d870008605da9

😎 Browse the preview: https://deploy-preview-495--mystifying-fermi-1bc096.netlify.app

@vkarpov15 vkarpov15 merged commit bef3984 into master Jul 12, 2021
@vkarpov15 vkarpov15 deleted the vkarpov15/node-task-queues-workers branch July 12, 2021 21:12
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.

None yet

4 participants