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

Spec contributor's guide #1004

Open
pjcozzi opened this issue Jun 8, 2017 · 4 comments
Open

Spec contributor's guide #1004

pjcozzi opened this issue Jun 8, 2017 · 4 comments

Comments

@pjcozzi
Copy link
Member

pjcozzi commented Jun 8, 2017

Before our next big spec updates, it would be great if someone wants to write a short guide on spec editing with a section on terminology so we use consistent terms for the runtime, converters, implementation notes, etc.

For example, here's the guide for 3D Tiles: https:/AnalyticalGraphicsInc/3d-tiles/blob/master/CONTRIBUTING.md

CC #1002

@pjcozzi
Copy link
Member Author

pjcozzi commented Jan 17, 2018

Example: avoid multiple inheritance in JSON schema

CC @javagl
CC #1144

@pjcozzi
Copy link
Member Author

pjcozzi commented Feb 26, 2018

Well said by @lexaknyazev:

We usually regard schemas' descriptions as more formal and README.md as more approachable.

CC #1229 (comment)

@donmccurdy
Copy link
Contributor

It seems like various authors have submitted extension specs and schema more or less successfully - is this guide still needed, or should we close this?

@pjcozzi
Copy link
Member Author

pjcozzi commented Jan 24, 2019

Still seems valuable given extension inconsistencies in #1491, right?

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

No branches or pull requests

2 participants