Re: Use Cases for Swagger Editor/UI/Codegen?

2017-12-11 Thread Ron Ratovsky
Your descriptions are pretty much right. There’s no overlap between the tools as they use each other. The Editor uses the UI for rendering (so you can get live feedback of what you’re creating) and it uses the codegen to generate the code. From: on behalf of mkim Reply-To: "sw

Re: Automatic Documentation Generation

2017-12-11 Thread Ron Ratovsky
Hi, Your question is a bit unclear. What is an OpenAPI compliant API spec? And what do you consider to be documentation? People use these terms to mean different things. From: on behalf of mkim Reply-To: "swagger-swaggersocket@googlegroups.com" Date: Monday, December 11, 2017 a

Automatic Documentation Generation

2017-12-11 Thread mkim
Hi, Is it possible to automatically generate documentation from an OpenAPI compliant API spec? I'm looking to integrate it as part of build processes. I'm still trying to get my machine set up so I can try all the tools (IT restrictions), but from what I understand, I can do something like thi

Use Cases for Swagger Editor/UI/Codegen?

2017-12-11 Thread mkim
Hi, I'm quite new to swagger and I’ve spent some time researching the tools. I'm still in the process of setting the tools up so I haven't been able to play with them fully(IT restrictions!). It’s not 100% clear to me the usage/benefits of Swagger UI standalone, as well as the differences bet

Is it possible to modify / extend @ApiOperation in-band i.e. not forking the project?

2017-12-11 Thread objitsu
Hi, Given Java-s still appalling inability to handle multi-line strings, it's a real PITA to have a neat looking "notes" string in your source code. My idea was to allow the use of a URL to specify the actual contents of the string, something like: @ApiOperation(value="", notes="file:///...")

Integrating Azure Cognitive services with Robotic Process Automation

2017-12-11 Thread emma blisa
I have seen Microsoft Cognitive services such as text analytics and some other services. Here I have gone through RPA and now I need to integrate RPA with any kind of Cognitive services, just for a demo purpose. Do we have any reference for that to understand much about it ? If I need to use

Re: Sample code in multiple language

2017-12-11 Thread Илья Чайка
UPD: There is for example https://help.apiary.io/tools/code-examples/ понедельник, 11 декабря 2017 г., 12:38:28 UTC+2 пользователь Илья Чайка написал: > > Hello guys! > > I`m using Swagger 2 for my own API and I have one trouble. I need to put > sample > code in multiple language in my docs. Bu

Sample code in multiple language

2017-12-11 Thread Илья Чайка
Hello guys! I`m using Swagger 2 for my own API and I have one trouble. I need to put sample code in multiple language in my docs. But I can not find any info how I can put it there. I have just one question. Do you have some special tags for code examples? Or I need to do it custom? -- You re