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

doc: add notes for the 2017-04-11 meeting #165

Closed
wants to merge 1 commit into from
Closed

Conversation

aqrln
Copy link
Member

@aqrln aqrln commented May 12, 2017

2017-04-11 JSTP Core Maintainers Meeting

Invited:

Present:

Agenda

  1. Contribution guidelines.
  2. Relationship with https://github.com/jstp.
  3. Compliance with JSON5 specs. The future of our custom data formats.
  4. The front page of the project.

Decisions

1. Contribution guidelines

The number of active contributors has doubled over the last time, so the existing policy that allowed landing PRs as soon as they are approved does not work anymore. We have already encountered a situation when a PR has landed prematurely without a proper review from a collaborator other than one who had reviewed it and, consequently, without addressing their feedback. Because of that we need a minimal waiting time, which we have agreed upon to be 24 hours, skipping weekends and holidays.

That, and all the conventions that we have had, must be documented.

2. Relationship with https://github.com/jstp.

Using the name "JSTP" when another similar project with the same name has already existed (even though it has been inactive for a long time) is inappropriate, may lead to confusion and is a potential infringement. We must get in touch with the people behind it and either get approval to use the name or rename our project.

3. Compliance with JSON5 specs. The future of our custom data formats.

What has been called "Record Serialization" should be plain JSON5. Given the fact that we have implemented some minor features not present in JSON5 specs (like ES2015 syntax for octal and binary literals), it is okay if we keep them, but the parser must be able to parse any valid JSON5 and the serializer must emit strict JSON5. In the future we might also consider decoupling the serdes facilities built into the JSTP into a separate npm package (like "fast-json5" or "metarhia-json5").

What has been called "Object Serialization" should be removed from the codebase. There's no sensible use case for it and there's no way to implement it in secure and performant fashion.

4. The front page of the project.

The README.md file should be updated to reflect the current vision of the project. It is misleading in some points and makes people who try to get acquainted with the project confused. Besides that, a new section with the list of the project's maintainers should be added.

Copy link
Member

@lundibundi lundibundi left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@nechaido nechaido left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Member

@belochub belochub left a comment

Choose a reason for hiding this comment

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

LGTM

belochub pushed a commit that referenced this pull request May 15, 2017
PR-URL: #165
Reviewed-By: Denys Otrishko <shishugi@gmail.com>
Reviewed-By: Dmytro Nechai <nechaido@gmail.com>
Reviewed-By: Mykola Bilochub <nbelochub@gmail.com>
@belochub
Copy link
Member

Landed in a6a5c7e. 🎉

@belochub belochub closed this May 15, 2017
@belochub belochub deleted the 2017-04-11-meeting branch May 15, 2017 19:10
nechaido pushed a commit that referenced this pull request May 18, 2017
PR-URL: #165
Reviewed-By: Denys Otrishko <shishugi@gmail.com>
Reviewed-By: Dmytro Nechai <nechaido@gmail.com>
Reviewed-By: Mykola Bilochub <nbelochub@gmail.com>
belochub pushed a commit that referenced this pull request Jan 22, 2018
PR-URL: #165
Reviewed-By: Denys Otrishko <shishugi@gmail.com>
Reviewed-By: Dmytro Nechai <nechaido@gmail.com>
Reviewed-By: Mykola Bilochub <nbelochub@gmail.com>
belochub pushed a commit that referenced this pull request Jan 22, 2018
PR-URL: #165
Reviewed-By: Denys Otrishko <shishugi@gmail.com>
Reviewed-By: Dmytro Nechai <nechaido@gmail.com>
Reviewed-By: Mykola Bilochub <nbelochub@gmail.com>
@belochub belochub mentioned this pull request Jan 22, 2018
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