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

Documentation about our development process #82

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

Conversation

michelguerin
Copy link
Collaborator

Add new content to the documentation as we discuss earlier @trusz (styling, dev process)

Some parts are more based on my intuition of how things already work in the project (trunk base, conventional commit).
We did not discuss it in the team. If it's outside the scope, we can take it out for now.

@michelguerin michelguerin requested a review from trusz September 20, 2024 12:36
michelguerin and others added 5 commits October 2, 2024 16:39
* feat(global): add biome as linter (in place of eslint) and formatter

* feat(monorepo): remove vscode settings from source control

* feat(monorepo): change biome formatter indent width to 4
* feat: init

- instantiate canvas boilerplate
- add xml queries to read LDType from .scd

* feat: add primitive bay node design

* feat: add control buttons and remaining search queries

(dirty version)
- add remaining search queries, their wrappers and types
- complete the prototype version of showing all variations of types available
- add buttons to add new types (inactive)
- small refactor of bay component

* perf(ce): Limit GSEControl querry to parent (#51)

* perf: Limit GSEControl querry to parent

* perf: Search in correct IED for control

* feat: correctly show fetched nodes

* fix: show props only if value exists

* feat: write to SCD: v.0.1

* feat(ce): increment version to trigger github action (#77)

* deploy: fix actions triggers (#79)

* deploy: test actions trigger

* deploy: increment communication explorer plugin version for test purpose

* deploy: reverse version increment on communication explorer plugin as test is done

* deploy: change paths that triggers the actions to reflect the monorepo tree

* fix: correctly pass event to its dispatcher

* fix: typo in variable name

* Deploy: fix github actions authentication (#81)

* deploy: test actions trigger

* deploy: increment communication explorer plugin version for test purpose

* deploy: reverse version increment on communication explorer plugin as test is done

* deploy: change paths that triggers the actions to reflect the monorepo tree

* deploy: change the way action script is pushing to the gh-pages branch as per the docs

* deploy: increment communication explorer plugin version for test purpose

* deploy: change the fit push command on build.yml to use the GITHUB_TOKEN

* deploy: increment communication explorer plugin version for test purpose

* deploy: comment out secrets in build:yml

* deploy: increment communication explorer plugin version for test purpose

* deploy: comment out secrets in plugin_communication-explorer.yml

* deploy: increment communication explorer plugin version for test purpose

* deploy: reverse version increment on communication explorer plugin as test is done

* deploy: remove all personal token references in favor of the GITHUB_TOKEN

* deploy: remove the trigger for this specific branch

* feat: events setup - auto update doc on important changes

* feat: correct nodes options

* feat: node component

* feat: small clean-up

* feat: complete event list - full functionality

* feat: add primitive node configuration

* fix: re-add deleted searchLNodeTypes

* fix: correct event receiving model

* feat: clean-up

* fix: update todo

* feat: real-time doc update on createNode + fix wrong names in scd

* chore: clean-up

* chore: clean-up

* feat(type-designer): rework of the plugin

I reworked this draft to allow myself to enter both in svelte and the project.
I simplified the business logic which I transferred to the core package (separate PR).

* Structure convention on Core (#85)

* feat(type-designer): rewrite of the typedesigner logic + new structure convention

New structure convention can be found as ADR 0004
It is used here for the implementation of the new type designer logic
Some unused files have been moved to a specific folder waiting approval before deletion

* feat(adr): add more precisions to the adr

* Add biome as linter (in place of eslint) and formatter (#86)

* feat(global): add biome as linter (in place of eslint) and formatter

* feat(monorepo): remove vscode settings from source control

* feat(monorepo): change biome formatter indent width to 4

* feat: init

- instantiate canvas boilerplate
- add xml queries to read LDType from .scd

* feat: add primitive bay node design

* feat: add control buttons and remaining search queries

(dirty version)
- add remaining search queries, their wrappers and types
- complete the prototype version of showing all variations of types available
- add buttons to add new types (inactive)
- small refactor of bay component

* feat: correctly show fetched nodes

* fix: show props only if value exists

* feat: write to SCD: v.0.1

* fix: correctly pass event to its dispatcher

* fix: typo in variable name

* feat: events setup - auto update doc on important changes

* feat: correct nodes options

* feat: node component

* feat: small clean-up

* feat: complete event list - full functionality

* feat: add primitive node configuration

* fix: re-add deleted searchLNodeTypes

* fix: correct event receiving model

* feat: clean-up

* fix: update todo

* feat: real-time doc update on createNode + fix wrong names in scd

* chore: clean-up

* chore: clean-up

* feat(type-designer): rework of the plugin

I reworked this draft to allow myself to enter both in svelte and the project.
I simplified the business logic which I transferred to the core package (separate PR).

* Structure convention on Core (#85)

* feat(type-designer): rewrite of the typedesigner logic + new structure convention

New structure convention can be found as ADR 0004
It is used here for the implementation of the new type designer logic
Some unused files have been moved to a specific folder waiting approval before deletion

* feat(adr): add more precisions to the adr

* feat(type-designer): change minor things after review + biome formatting core and type designer

---------

Co-authored-by: Illia Solovei <[email protected]>
Co-authored-by: Christopher Lepski <[email protected]>
Co-authored-by: Michel Guerin <[email protected]>
Co-authored-by: Michel Guerin <[email protected]>
Copy link
Collaborator

@trusz trusz left a comment

Choose a reason for hiding this comment

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

❤️ Documentation
I'd just have a few hints and questions.

.vscode/settings.json Show resolved Hide resolved
@@ -0,0 +1,132 @@
# Contributor Covenant Code of Conduct
Copy link
Collaborator

Choose a reason for hiding this comment

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

I think we should discuss this in the team and see if it is compatible with the project.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

This PR is a proposition for these Open Source project base files ;)

doc/guidelines/code_style.md Outdated Show resolved Hide resolved
## Sprint Backlog

* When you are assigned to an issue from the Sprint Backlog, please do the following:
* Create a ney branch following the
Copy link
Collaborator

Choose a reason for hiding this comment

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

The rest of the sentence is missing :)

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Ah oups ! I made a proposition for a simple branch naming convention.

* On MacOS: `brew install node@20`
* Package manager [pnpm](https://pnpm.io/)
* On MacOS: `brew install pnpm`
* Enable corepack afterwards : `sudo corepack enable`
Copy link
Collaborator

Choose a reason for hiding this comment

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

I believe if you have node, you don't have to install pnpm just enable the corepack

Comment on lines +27 to +28
* Mural Read-Access
Copy link
Collaborator

Choose a reason for hiding this comment

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

These are internal tools. If external developers want to contribute we will find another way. I don't think we need Mural for development, everything that is necessary for the development should be part of the issue.


## Version control management practice

We are following the [trunk-based development rules](https://trunkbaseddevelopment.com/) : one trunk (main), short life feature branches that should not live longer than a sprint.
Copy link
Collaborator

Choose a reason for hiding this comment

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

short-lived instead of short life :)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants