Skip to content

feat: Review & improve documentation before release#212

Merged
ricardozanini merged 8 commits into
open-workflow-specification:mainfrom
handreyrc:update-documentation
Jul 6, 2026
Merged

feat: Review & improve documentation before release#212
ricardozanini merged 8 commits into
open-workflow-specification:mainfrom
handreyrc:update-documentation

Conversation

@handreyrc

Copy link
Copy Markdown
Contributor

Closes: #195

Summary

This PR aims to review and update all *.md files in the project to reflect the latest code.

Changes

The following files where reviewed and updated

  • ./CONTRIBUTING.md
  • ./README.md
  • ./packages/i18n/README.md
  • ./packages/serverless-workflow-diagram-editor/src/core/README.md
  • ./packages/serverless-workflow-diagram-editor/src/react-flow/README.md
  • ./packages/serverless-workflow-diagram-editor/README.md

Copilot AI review requested due to automatic review settings July 1, 2026 01:50
@handreyrc handreyrc self-assigned this Jul 1, 2026
@netlify

netlify Bot commented Jul 1, 2026

Copy link
Copy Markdown

Deploy Preview for swf-editor ready!

Name Link
🔨 Latest commit 70c8c1f
🔍 Latest deploy log https://app.netlify.com/projects/swf-editor/deploys/6a4bcb7c2178190008a1f50e
😎 Deploy Preview https://deploy-preview-212--swf-editor.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@handreyrc handreyrc added the documentation Improvements or additions to documentation label Jul 1, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Documentation-focused PR to refresh project and package READMEs ahead of release, clarifying setup commands, monorepo structure, and package usage.

Changes:

  • Expanded root README.md with overview, quick-start, dev/test commands, and architecture/CI notes.
  • Updated package READMEs (diagram-editor, i18n, and internal core/react-flow docs) with clearer structure and API/architecture descriptions.
  • Enhanced CONTRIBUTING.md with updated stack/testing sections and Git hook/DCO guidance.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
README.md Adds project overview, quick start, dev workflow, stack/architecture, and CI/release/community sections.
CONTRIBUTING.md Updates contributor guidance (stack, reporting, hooks/DCO, testing/CI).
packages/i18n/README.md Rewrites as a package README with features, API reference, usage, and dev notes.
packages/serverless-workflow-diagram-editor/README.md Updates to published package name, installation/usage, structure, and architecture principles.
packages/serverless-workflow-diagram-editor/src/core/README.md Expands module-level documentation and SDK-isolation guidance for the core layer.
packages/serverless-workflow-diagram-editor/src/react-flow/README.md Greatly expands React Flow directory documentation and responsibilities.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/src/core/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Comment thread CONTRIBUTING.md
Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/README.md Outdated
@lornakelly

Copy link
Copy Markdown
Contributor

@handreyrc Thanks for the PR, just added some small comments and if you could also update the storybook welcome page to replace the TODO, thanks

@fantonangeli fantonangeli left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I only left one fix, but I would say there are a few docs here that we need to keep updated in the future.

Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Comment thread CONTRIBUTING.md Outdated
handreyrc added 3 commits July 3, 2026 16:23
Signed-off-by: handreyrc <handrey.cunha@gmail.com>
Signed-off-by: handreyrc <handrey.cunha@gmail.com>
Signed-off-by: handreyrc <handrey.cunha@gmail.com>
Copilot AI review requested due to automatic review settings July 3, 2026 21:18
@handreyrc handreyrc force-pushed the update-documentation branch from f252e9a to 4dede19 Compare July 3, 2026 21:18

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Comment thread packages/serverless-workflow-diagram-editor/src/core/README.md Outdated
Comment thread packages/serverless-workflow-diagram-editor/src/react-flow/README.md Outdated
Signed-off-by: handreyrc <handrey.cunha@gmail.com>

@fantonangeli fantonangeli left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

Comment thread README.md

@lornakelly lornakelly left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

Signed-off-by: handreyrc <handrey.cunha@gmail.com>
Copilot AI review requested due to automatic review settings July 6, 2026 14:50

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Comment thread packages/serverless-workflow-diagram-editor/src/core/README.md
Comment thread packages/serverless-workflow-diagram-editor/stories/README.md Outdated
Comment thread packages/i18n/README.md Outdated
Signed-off-by: handreyrc <handrey.cunha@gmail.com>
@handreyrc

Copy link
Copy Markdown
Contributor Author

@lornakelly @fantonangeli,

I updated the storybook welcome page so we don't have that TODO there anymore.
Please take a look.

Thanks!

Comment thread packages/serverless-workflow-diagram-editor/stories/introduction/Welcome.mdx Outdated
Comment thread packages/serverless-workflow-diagram-editor/stories/introduction/Welcome.mdx Outdated
Comment thread packages/serverless-workflow-diagram-editor/stories/introduction/Welcome.mdx Outdated
Signed-off-by: handreyrc <handrey.cunha@gmail.com>
Copilot AI review requested due to automatic review settings July 6, 2026 15:17

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 9 out of 9 changed files in this pull request and generated 5 comments.

Comment thread packages/serverless-workflow-diagram-editor/src/core/README.md
Comment thread README.md
Comment thread packages/serverless-workflow-diagram-editor/README.md
Comment thread packages/i18n/README.md Outdated
Comment thread packages/i18n/README.md

@lornakelly lornakelly left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LGTM

Signed-off-by: handreyrc <handrey.cunha@gmail.com>
@handreyrc handreyrc requested a review from ricardozanini July 6, 2026 20:45
@handreyrc

Copy link
Copy Markdown
Contributor Author

@ricardozanini,

If you have no futrher considerations this PR should be good enough to be merged.

Thanks!

@ricardozanini ricardozanini merged commit 5f3a5d7 into open-workflow-specification:main Jul 6, 2026
12 checks passed
@github-project-automation github-project-automation Bot moved this from Backlog to Done in Editor Project Tracker Jul 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: Review & improve documentation before release

6 participants