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

Create CONTRIBUTING.md and explain LSP proposal process #305

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

Conversation

CJ42
Copy link
Member

@CJ42 CJ42 commented Nov 6, 2024

No description provided.

@CJ42 CJ42 force-pushed the docs/contributes-md branch 2 times, most recently from 9e23f66 to 220bf56 Compare November 6, 2024 07:51

This section provides guidelines for how to propose a new LSP standard **before opening a Pull Requests** to the LSP repository.

We recomment any new proposer to review the `LIPs/lip-1.md` document for further details on how to propose new standards, the review process and guidelines on how to propose new standards and the content it should include.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
We recomment any new proposer to review the `LIPs/lip-1.md` document for further details on how to propose new standards, the review process and guidelines on how to propose new standards and the content it should include.
We recommend any new proposer to review the `LIPs/lip-1.md` document for further details on how to propose new standards, the review process and guidelines on how to propose new standards and the content it should include.

Copy link
Member

Choose a reason for hiding this comment

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

Also, the same phrase is used making the sentence read a little strange.

Screenshot 2024-11-06 at 14 34 44

2. Fork the repository by clicking "Fork" in the top right.
3. Add your LIP to your fork of the repository. There is a [template LIP here](lip-X.md).
4. Submit a Pull Request to LUKSO's [LIPs repository](https://github.com/lukso-network/LIPs).
Anyone is welcomed to make a PR to an existing LSP for fixes related to grammar or improvements related to the descriptions of an LSP specification.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Anyone is welcomed to make a PR to an existing LSP for fixes related to grammar or improvements related to the descriptions of an LSP specification.
Anyone is welcome to make a PR to an existing LSP for fixes related to grammar or improvements related to the descriptions of an LSP specification.

- **Draft** -- Once the first draft has been merged, you may submit follow-up pull requests with further changes to your draft until such point as you believe the LIP to be mature and ready to proceed to the next status. An LIP in draft status must be implemented to be considered for promotion to the next status (ignore this requirement for core LIPs).
- :arrow_right: Last Call -- If agreeable, the LIP editor will assign Last Call status and set a review end date (`review-period-end`), normally 14 days later.
- :x: Last Call -- A request for Last Call status will be denied if material changes are still expected to be made to the draft. We hope that LIPs only enter Last Call once, so as to avoid unnecessary noise on the RSS feed.
- **Last Call** -- This LIP is listed and documented prominently on the https://docs.lukso.tech/ websiteå.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- **Last Call** -- This LIP is listed and documented prominently on the https://docs.lukso.tech/ websiteå.
- **Last Call** -- This LIP is listed and documented prominently on the https://docs.lukso.tech/ website.


The goal of this process is to iterate over the initial idea and refine:

- what the specification for the LSP should contain.
Copy link
Member

Choose a reason for hiding this comment

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

Not sure I get this sentence. Is it to discuss what should be specified in an LSP?


One or multiple editors will manually review the first PR for a new LSP and assign it a number before merging it.

When you believe your LIP is mature and ready to progress past the draft phase, you should do open a PR changing the state of your LIP to 'Final'. An editor will review your draft and ask if anyone objects to its being finalised. If the editor decides there is no rough consensus - for instance, because contributors point out significant issues with the LIP - they may close the PR and request that you fix the issues in the draft before trying again.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
When you believe your LIP is mature and ready to progress past the draft phase, you should do open a PR changing the state of your LIP to 'Final'. An editor will review your draft and ask if anyone objects to its being finalised. If the editor decides there is no rough consensus - for instance, because contributors point out significant issues with the LIP - they may close the PR and request that you fix the issues in the draft before trying again.
When you believe your LIP is mature and ready to progress past the draft phase, you should do open a PR changing the state of your LIP to 'Final'. An editor will review your draft and ask if anyone objects to it being finalised. If the editor decides there is no rough consensus - for instance, because contributors point out significant issues with the LIP - they may close the PR and request that you fix the issues in the draft before trying again.

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

Successfully merging this pull request may close these issues.

2 participants