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

Add implementation guide #22

Merged
merged 3 commits into from
Jun 1, 2018
Merged

Add implementation guide #22

merged 3 commits into from
Jun 1, 2018

Conversation

littledan
Copy link
Member

Closes #9

cc @gsathya

implement.md Outdated

TC39 appreciates implementers! In addition to getting features to JS developers, the process of implementation gives detailed sense of the feature within the language as a whole and its various interactions, leading to important insights about the design.

ll kinds of feedback are appreciated from implementers, whether it's about the motivation, high-level design, integration with various other systems, implementation complexity, or the semantics of edge cases. The best way to give feedback is through filing bugs in the GitHub repository. Feel free to make PRs against the draft spec for suggested semantic changes, as well.
Copy link
Member

Choose a reason for hiding this comment

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

s/ll/All

Copy link
Member

Choose a reason for hiding this comment

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

also, "in the GitHub repository for the proposal" - ie, not in ecma262

Copy link
Member Author

Choose a reason for hiding this comment

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

Done

- Eliminate link to .babelrc
- s/ll/All/
- Clarify PRs welcome against proposal repo
implement.md Outdated

At Stage 0, 1 and 2, semantic details are up in the air. The committee has not come to consensus on all of the concrete details of the proposal. Implementations at this stage should be considered experimental and speculative. Implementations at this stage can be very valuable to enable experimentation by programmers, which can help refine the language design. Implementations tend to expose this stage of feature via special flags which are not enabled by default.

### Case studies
Copy link
Member

Choose a reason for hiding this comment

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

I'm ok with saying what you say about V8, but don't feel comfortable signing off for other engines here. Especially since this is incorrect: JSC and ChakraCore ship dynamic import which is Stage 3. I would just remove this section entirely, since it doesn't add as much value as the other sections.

Copy link
Member Author

Choose a reason for hiding this comment

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

Thanks for the review; removed the section.

@gsathya
Copy link
Member

gsathya commented May 26, 2018

Thanks!

@littledan
Copy link
Member Author

OK, feedback has been addressed, so landing this PR. If you have any other concerns, let's fix them in a follow-on patch.

@littledan littledan merged commit 1b5155b into master Jun 1, 2018
@ljharb ljharb deleted the implement branch June 1, 2018 20:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants