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.

Sign up for GitHub

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

Jump to bottom

Is this the right place for style improvement discussions for ABI EIP documents? #2

Open
davesque opened this issue Nov 22, 2018 · 0 comments
Open

Is this the right place for style improvement discussions for ABI EIP documents? #2

davesque opened this issue Nov 22, 2018 · 0 comments

Comments

@davesque
Copy link
Member

davesque commented Nov 22, 2018 •
edited
Loading

I'm wondering if this is the right place to discuss the following things about the EIP documents that we're composing as part of this ABI standardization work:

  • Style/flow improvements to the base content (which came from the Solidity docs and was composed by many contributors)
  • Decisions about how much expository text to include vs. terse mathematical definitions (I had some ideas for adding expository sections but maybe it's appropriate for the spec itself to use a mathematical style of definition and leave the exposition to some kind of supplementary document that is not part of an EIP.)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@davesque