fix #11 - Governance, contribution, templates by ricardozanini · Pull Request #13 · serverlessworkflow/editor

ricardozanini · 2026-03-02T22:51:07Z

Closes #11

Contribution.md is quite generic, since I understand this is a mutable document for now until we have more details about our stack.

Signed-off-by: Ricardo Zanini <ricardozanini@gmail.com>

Copilot

Pull request overview

Adds foundational governance, contribution, and community process documentation for the Serverless Workflow Editor repository, aligning with Issue #11’s goal of improving onboarding and project management clarity.

Changes:

Adds top-level governance, contributing, and code of conduct documents (with links to CNCF/parent project policies).
Introduces GitHub Issue Forms templates (bug report, feature request, question) and disables blank issues.
Adds a support contact link directing users to the project’s Slack channel.

Reviewed changes

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

Show a summary per file

File	Description
`GOVERNANCE.md`	Adds governance pointer to the parent specification repo and a community support link.
`CONTRIBUTING.md`	Adds contribution workflow guidance plus (currently non-actionable) local build/dev instructions.
`CODE_OF_CONDUCT.md`	Adds CNCF Code of Conduct reference and reporting instructions (includes an unresolved TODO block).
`.github/ISSUE_TEMPLATE/config.yml`	Disables blank issues and adds a Slack contact link.
`.github/ISSUE_TEMPLATE/bug_report.yml`	Adds structured bug report form.
`.github/ISSUE_TEMPLATE/feature_request.yml`	Adds structured feature request form with DoD checklist.
`.github/ISSUE_TEMPLATE/question.yml`	Adds structured question/general feedback form.

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

CODE_OF_CONDUCT.md

.github/ISSUE_TEMPLATE/config.yml

CONTRIBUTING.md

GOVERNANCE.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

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

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

JBBianchi

I think it's a good base, thanks ric!

CONTRIBUTING.md

Co-authored-by: Jean-Baptiste Bianchi <72747835+JBBianchi@users.noreply.github.com>

Copilot

Pull request overview

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

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

CONTRIBUTING.md

.github/ISSUE_TEMPLATE/question.yml

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

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

.github/ISSUE_TEMPLATE/feature_request.yml

fantonangeli

@ricardozanini LGTM, Thanks for this PR.
I left a few suggestion, but not required.

CONTRIBUTING.md

.github/ISSUE_TEMPLATE/bug_report.yml

Co-authored-by: Fabrizio Antonangeli <fabrizio.antonangeli@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot

Pull request overview

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

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

Copilot · 2026-03-05T15:37:53Z

CONTRIBUTING.md

+## Prerequisites
+
+To build and run the editor locally, you will need:
+- **Node.js** (v24.x or higher)


The Node.js prerequisite is very specific, but the repo currently doesn’t define an expected Node version anywhere (no package.json with engines, .nvmrc, etc.). To avoid misleading contributors, either add a single source of truth for the Node version (and reference it here) or change this to a less specific requirement (e.g., “current LTS”).

Suggested change

- **Node.js** (v24.x or higher)

- **Node.js** (current LTS version; see https://nodejs.org/)

Copilot · 2026-03-05T15:37:53Z

CONTRIBUTING.md

+The project is structured as a monorepo to support multiple distribution targets (Web, VS Code, etc.) as defined in our architectural decisions.
+
+```bash
+# Clone the repository
+git clone https://github.com/serverlessworkflow/editor.git
+cd editor
+
+# Install dependencies
+npm install
+
+# Build all packages in the monorepo
+npm run build
+```
+


These build instructions assume a JS/TS monorepo with a root package.json and an npm run build script, but this repository currently contains only documentation files (no package.json). Please either add the missing project scaffolding/scripts or adjust this section to match the current repo state (e.g., mark build steps as TBD).

Suggested change

The project is structured as a monorepo to support multiple distribution targets (Web, VS Code, etc.) as defined in our architectural decisions.

```bash

# Clone the repository

git clone https://github.com/serverlessworkflow/editor.git

cd editor

# Install dependencies

npm install

# Build all packages in the monorepo

npm run build

```

This repository currently contains documentation content only and does not define a Node.js project (there is no root `package.json`).

As a result, there is no build step required at this time. When implementation code is added to this repository in the future, this section will be updated with the appropriate setup and build instructions (TBD).

Copilot · 2026-03-05T15:37:54Z

CODE_OF_CONDUCT.md

+We follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).
+
+
+Please contact the [CNCF Code of Conduct Committee](mailto:conduct@cncf.io)
+in order to report violations of the Code of Conduct.


Minor punctuation/formatting: there’s an extra blank line, and the “Please contact…” sentence doesn’t end with a period. Consider collapsing to a single paragraph and ending the sentence cleanly.

Suggested change

We follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).

Please contact the [CNCF Code of Conduct Committee](mailto:conduct@cncf.io)

in order to report violations of the Code of Conduct.

We follow the [CNCF Code of Conduct](https://github.com/cncf/foundation/blob/main/code-of-conduct.md). Please contact the [CNCF Code of Conduct Committee](mailto:conduct@cncf.io) in order to report violations of the Code of Conduct.

Copilot · 2026-03-05T15:37:54Z

.github/ISSUE_TEMPLATE/bug_report.yml

+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Step to reproduce


Grammar: the label reads “Step to reproduce” but the description/placeholder describe multiple steps. Consider changing the label to “Steps to reproduce”.

Suggested change

label: Step to reproduce

label: Steps to reproduce

Signed-off-by: Ricardo Zanini <ricardozanini@gmail.com>

fix serverlessworkflow#11 - Governance, contribution, templates

4ac4eec

Signed-off-by: Ricardo Zanini <ricardozanini@gmail.com>

ricardozanini requested review from JBBianchi, Copilot, handreyrc and lornakelly March 2, 2026 22:51

Copilot started reviewing on behalf of ricardozanini March 2, 2026 22:51 View session

Copilot AI reviewed Mar 2, 2026

View reviewed changes

Apply suggestions from code review

d387d84

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 2, 2026 22:56

Copilot started reviewing on behalf of ricardozanini March 2, 2026 22:57 View session

Copilot AI reviewed Mar 2, 2026

View reviewed changes

JBBianchi reviewed Mar 3, 2026

View reviewed changes

CONTRIBUTING.md Outdated Show resolved Hide resolved

Upgrade Node.js version

a29d987

Co-authored-by: Jean-Baptiste Bianchi <72747835+JBBianchi@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 3, 2026 15:48

Copilot AI reviewed Mar 3, 2026

View reviewed changes

CONTRIBUTING.md Outdated Show resolved Hide resolved

.github/ISSUE_TEMPLATE/question.yml Outdated Show resolved Hide resolved

Apply suggestions from code review

db0d5a7

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 3, 2026 16:00

Copilot AI reviewed Mar 3, 2026

View reviewed changes

.github/ISSUE_TEMPLATE/feature_request.yml Outdated Show resolved Hide resolved

Copilot started reviewing on behalf of ricardozanini March 3, 2026 16:10 View session

Copilot started reviewing on behalf of ricardozanini March 3, 2026 16:16 View session

fantonangeli reviewed Mar 3, 2026

View reviewed changes

CONTRIBUTING.md Outdated Show resolved Hide resolved

CONTRIBUTING.md Show resolved Hide resolved

.github/ISSUE_TEMPLATE/bug_report.yml Outdated Show resolved Hide resolved

.github/ISSUE_TEMPLATE/bug_report.yml Show resolved Hide resolved

Apply @fantonangeli suggestions from code review

8806531

Co-authored-by: Fabrizio Antonangeli <fabrizio.antonangeli@gmail.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 5, 2026 15:34

Copilot started reviewing on behalf of ricardozanini March 5, 2026 15:35 View session

Copilot AI reviewed Mar 5, 2026

View reviewed changes

Add expected behavior

30c9d4e

Signed-off-by: Ricardo Zanini <ricardozanini@gmail.com>

	- Node.js (v24.x or higher)
	- Node.js (current LTS version; see https://nodejs.org/)

Conversation

ricardozanini commented Mar 2, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

JBBianchi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

fantonangeli left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Copilot AI Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants