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

pull things that aren't JavaScript specific into a separate section #158

Closed
dbaron opened this issue Mar 3, 2020 · 1 comment · Fixed by #161
Closed

pull things that aren't JavaScript specific into a separate section #158

dbaron opened this issue Mar 3, 2020 · 1 comment · Fixed by #161
Assignees

Comments

@dbaron
Copy link
Member

dbaron commented Mar 3, 2020

Before I work on #126, I'd like to do a little bit of restructuring to separate parts of the design-principles document that are specific to JavaScript from parts that are cross-language.

In particular, we currently have the following two toplevel sections:

  • JavaScript Language
  • API Surface Concerns

What I'd like to do is rename the latter "API Surface Concerns" to "Javascript API Surface Concerns", and at the same time pull 4 of its subsections:

  • Naming things
  • New features should be detectable
  • Use casing rules consistent with existing APIs
  • Consider limiting new features to secure contexts

into a new toplevel section, perhaps called "API Design Across Languages", and put this before the "JavaScript Language" section. When doing this I'd also swap the order of the middle two so that the two naming-related subsections "Naming things" and "Use casing rules consistent with existing APIs" would be next to each other.

Does this seem reasonable?

@dbaron dbaron self-assigned this Mar 3, 2020
@hober
Copy link
Contributor

hober commented Mar 3, 2020

Sounds good to me!

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