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

[Feature Request] Expand the list of examples on the Example applications page #311

Open
webchick opened this issue Sep 27, 2024 · 1 comment
Assignees
Labels
enhancement New feature or request

Comments

@webchick
Copy link
Contributor

webchick commented Sep 27, 2024

(Corresponding internal ticket: EDU-1842)

Is your feature request related to a problem? Please describe.

Right now, https://learn.temporal.io/examples/ only lists a single example (Background Checker), in a single programming language (Go). A user who's new to Temporal might leave this page with the impression that Temporal is extremely limited in what it can do, and/or in the languages that it supports.

In reality, however, there are TONS of Temporal examples kicking around out there, among them:

But, without doing a bunch of sleuthing and/or without a great deal of random luck, you'd never ever know this as it stands today. 😢

Describe the solution you'd like

  1. The main thing? More than one example on that page. 🤣
  2. Along with this, introducing "categorization/taxonomy" of examples, so that we can start to expand out beyond simply the "end-to-end" applications (which are far less plentiful, and extremely time consuming to create)
  3. The simplest thing that can possibly work that accomplishes those two (at least for now).

Additional context

Community-contributed examples are a bit of a can of worms, so let's leave those out of scope for now. (But... working on it! :))

@tomwheeler
Copy link
Collaborator

FWIW, I think the OMS should definitely be listed here.

The SDK samples don't qualify as "Example Applications" in my opinion. They're valuable, for sure, but they're intended to demonstrate the use of a specific API instead of demonstrating how to implement a relatable use case. In some cases (such as the Expense Reporting sample for Go intended to demonstrate asynchronous Activity completion), they get close to what I'd call an example application, but most do not.

The SA demos certainly qualify as "example applications," although I'd say that we should consider inclusion on a case-by-case basis (and only if the developer/maintainer thinks it should be). Some may lack step-by-step instructions that would make it challenging for another person to run. Others may have been created to demonstrate a specific case to a specific group of people and may not be instructive outside that context.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants