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 diagram of how parsing works to contributing docs #820

Open
honzajavorek opened this issue Jul 17, 2017 · 2 comments
Open

Add diagram of how parsing works to contributing docs #820

honzajavorek opened this issue Jul 17, 2017 · 2 comments

Comments

@honzajavorek
Copy link
Contributor

@honzajavorek honzajavorek commented Jul 17, 2017

Add following image to contributing docs:

img_3399

Smaller scope could be put into fury.js README as well. In some sense this issue is similar to apiaryio/gavel-spec#12.

@honzajavorek
Copy link
Contributor Author

@honzajavorek honzajavorek commented Nov 21, 2017

Schema of inner Dredd architecture should be added to docs and explained as well. This is from our secret archives:

upload_2_1_2016_at_1_49_05_pm

@honzajavorek
Copy link
Contributor Author

@honzajavorek honzajavorek commented Feb 6, 2019

https://twitter.com/mtnygard/status/1079471792291491840

When diagramming, make sure your readers know a) what the elements are; b) what the relationships mean; and c) what the constraints are. That’s the meta-model necessary to understand the model.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
1 participant