Skip to content

Added Description Field Info for Custom Functions and Actions #319

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

Merged
merged 5 commits into from
Apr 22, 2025

Conversation

pinkeshmars
Copy link
Collaborator

Description

Added description field info for custom functions and actions.

Linear ticket and magic word Fixes DEVR-872

Type of change

  • Typo fix
  • New feature
  • Enhancement to current docs
  • Removed outdated references
  • Update assets

@pinkeshmars pinkeshmars requested a review from eilzo April 17, 2025 06:06
Copy link

Review PR in StackBlitz Codeflow Run & review this pull request in StackBlitz Codeflow.

@github-actions github-actions bot requested a review from PoojaB26 April 17, 2025 06:06
@@ -243,6 +243,16 @@ Here's an example of an Action that returns a _nullable_ integer.

![return-value-actions.png](imgs/return-value-actions.png)

## Adding Description
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
## Adding Description
## Descriptions

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Done!

@@ -243,6 +243,16 @@ Here's an example of an Action that returns a _nullable_ integer.

![return-value-actions.png](imgs/return-value-actions.png)

## Adding Description

You can add a [**Description**](../../intro/ff-ui/resource-hierarchy.md#resource-description) note on Custom Functions and Custom Actions to briefly explain their purpose, usage, or important details. This helps clarify what the function or action is intended for, making your project more understandable and maintainable—especially in libraries and collaborative environments.
Copy link
Collaborator

Choose a reason for hiding this comment

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

--also gets added to the function code documentation (reflects in code editor too)

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Done!

@pinkeshmars pinkeshmars requested a review from PoojaB26 April 18, 2025 05:57
@pinkeshmars
Copy link
Collaborator Author

Hi @PoojaB26 could you please quickly take a look again?

![view-description-custom-function-and-custom-action](imgs/view-description-custom-function-and-custom-action.avif)

:::tip
In the generated code, descriptions are added as comments above the custom code. In code editors, they appear as tooltips when you hover over the names of Custom Functions and Actions.
Copy link
Collaborator

Choose a reason for hiding this comment

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

In code editors, they appear as tooltips when you hover over the names of Custom Functions and Actions

Is this true though?
I mean its true in actions flow and properties editor, but not in custom code tab. which is what i mean by code editors. it only adds the description as a comment before the function definition.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Oops! My bad—I thought you were referring to IDEs when you said "code editor" No worries though, I’ve updated the text and added an image to make it more clear. Thanks for looking into :)

Copy link
Collaborator

@PoojaB26 PoojaB26 left a comment

Choose a reason for hiding this comment

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

Awesome, thanks!

@pinkeshmars pinkeshmars merged commit 5adaafb into main Apr 22, 2025
1 check passed
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.

3 participants