These are chat archives for APIs-guru/api-models

17th
Mar 2016
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 00:29
@sanchojaf Created #46
@sanchojaf @bobby-brennan @/all Somebody using https://apis-guru.github.io/api-models/internal_api/list.csv ?
I do code cleanup in background, and remove experiential features which no one use.
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 00:35
If no one respond I will remove it.
Maria Esther
@maryguirola
Mar 17 2016 18:10
@IvanGoncharov , in some repos you have a file named fixup.yaml and other file named patch.yaml. What are they for? What's the difference between them?
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 18:46
@maryguirola I need to write some docs explaining structure in future
short version
patch.yaml just add data
it doesn't change anything
so you can add something missing
like securityDefinition
for example
And it have very simple structure
it's exactly the same as Swagger format
I just merge it on top of swagger
during build
fixup.yaml is for changing data it more complicate format
since I need to check that API owner didn't fix that bug on his own or do other changes that affect fixup.yaml
for example I want to fix existing securityDefinition
and fix Oauth 2 url
I can't just override it
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 18:52
I need to check that API owner didn't fix it himself or change it to completely different url
Keep in mind I think about all patch as necessary evil, especially fixup.json
So I try to solve as much as possible problems inside my build scripts
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 18:57
If you know about some bug please report it on Github
and if have time to fix it write it inside Github issues
I will say if I have any plans to fix it automatically or you can help by creating PR with patches
I will try to answer ASAP
Maria Esther
@maryguirola
Mar 17 2016 20:15
thanks @IvanGoncharov , if I see some bug i will report it on Github
Ivan Goncharov
@IvanGoncharov
Mar 17 2016 20:16
If you have other questions I happily answer them.
I desperately need question for FAQ section, which I need to write