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 link to FEEL temporal expression examples #4428

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

falko
Copy link
Member

@falko falko commented Oct 8, 2024

Description

Link to very helpful examples from FEEL Scala docs

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support.
  • This is already available but undocumented and should be released within a week.
  • This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
  • This is part of a scheduled alpha or minor. (apply alpha or minor label)
  • There is no urgency with this change and can be released at any time.

PR Checklist

  • My changes are for an already released minor and are in /versioned_docs directory.
  • My changes are for the next minor and are in /docs directory (aka /next/).

Copy link
Contributor

github-actions bot commented Oct 8, 2024

👋 🤖 🤔 Hello! 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.6/.

  • docs/components/modeler/feel/language-guide/feel-temporal-expressions.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.

@@ -431,3 +431,6 @@ duration("PT2H30M").minutes
duration("P6M").months
// 6
```
### More Examples
Copy link
Contributor

Choose a reason for hiding this comment

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

[prettier] reported by reviewdog 🐶

Suggested change
### More Examples
### More Examples

@akeller akeller requested a review from a team October 8, 2024 13:37
@akeller
Copy link
Member

akeller commented Oct 8, 2024

I'd like to see a little more context around this link, but we should probably also backport it, maybe to all supported versions. @camunda/tech-writers can one of you assist Falko with both of those things? 🙂

@mesellings mesellings requested review from mesellings and removed request for a team October 8, 2024 13:42
@mesellings
Copy link
Contributor

@falko I'll take a look and backport as well for you 👍

@mesellings mesellings added kind/enhancement Issues related with enhancing existing documentation or the documentation structure (nice to have) component:docs Documentation improvements, including new or updated content labels Oct 8, 2024
@falko
Copy link
Member Author

falko commented Oct 8, 2024

The same FEEL Scala docs section also contains examples for other topics. Maybe we should just add them to the docs? @saig0 FYI

@saig0
Copy link
Member

saig0 commented Oct 9, 2024

@falko instead of adding a link to the FEEL-Scala docs, I would prefer adding the examples directly in the C8 docs. On a long-term, I would move all relevant content to the Camunda docs (and the code itself to the Camunda repo).

@mesellings
Copy link
Contributor

@saig0 @falko I think moving content into the docs may be quite a lift for this PR, and probably something we need to plan out - there are issues such as redirects/links to the github docs for example that we need to take into consideration.

Can I suggest the following plan:

For now (for this PR) we add the links in as suggested, and we can reference the examples a bit more clearly. For example:

Info: Temporal expression examples are available in the FEEL-Scala documentation, including how to compare and check dates, calculate age and duration, and change date format.

Then, we address moving relevant docs over (such as these examples) as part of a larger project?

@falko
Copy link
Member Author

falko commented Oct 9, 2024

@akeller can we just merge all examples from here: https://github.com/camunda/feel-scala/tree/main/docs/docs/learn/samples

Really helpfule, would be to somehow integrate the FEEL playground into the docs so that users can directly modify the examples to match their use cases. It could be done as a link near each example or even directly like how @saig0 did it in his FEEL Challenge. Having the examples in the playground could also be a way to maintain them, i.e. test that they still work.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:docs Documentation improvements, including new or updated content kind/enhancement Issues related with enhancing existing documentation or the documentation structure (nice to have)
Projects
Status: 👀 In Review
Development

Successfully merging this pull request may close these issues.

4 participants