Abhyudaya Sharma could you send your e-mail address to mark.earl.wa...@gmail.com so that I can invite you to the Jenkins organization that I created on swaggerhub?
I've started the conversation with Smartbear (the company that has created swaggerhub) to ask if they would be willing to donate hosting of the Jenkins organization. I'd love to spend time in the next two weeks during the trial period to further test the idea. On Fri, Aug 30, 2019 at 5:31 AM Mark Waite <mark.earl.wa...@gmail.com> wrote: > I like the idea of hosting the Jenkins REST API documentation on > swaggerhub. I think the GSoC 2019 project idea would make it even better. > > While trying to learn more about swaggerhub, I created an organization > called "Jenkins", assigned the e-mail address of Jenkins documentation > google group (jenkinsci-d...@googlegroups.com), and have invited several > people to join the organization as part of the experiment. The > organization is a 14 day trial plan, which I assume means that we'll need > to fund the hosting of the API spec there, or we'll need to negotiate with > them to donate hosting for the API. > > Let me know if you'd like an invitation to the trial organization that > I've created. We can evaluate for two weeks and use that time to negotiate > with SmartBear to ask them to donate hosting for the Jenkins project. > > Mark Waite > > I've sent > > On Wed, Aug 28, 2019 at 8:15 AM Oleg Nenashev <o.v.nenas...@gmail.com> > wrote: > >> Just to bump this thread, I would say that it would be great to have REST >> API specs hosted in a centralized ways, similar to plugin Javadocs >> <https://javadoc.jenkins.io/plugin/>. Looks like SwaggerHub offers a >> pretty good user experience, so why not? >> >> Some notes: >> >> - We could also make Swagger documentation upload a part of the >> plugin continuous delivery flow once it is ready >> - Same, we could add links to REST API specs to plugins.jenkins.io >> once there is a critical mass of plugins using such approach >> - The story would be really interesting if combined with the >> automatic Swagger spec generation for Jenkins plugins (GSoC 2019 >> project idea >> >> <https://jenkins.io/projects/gsoc/2019/project-ideas/automatic-spec-generator-for-jenkins-rest-api/> >> ) >> >> Best regards, >> Oleg >> >> On Wednesday, August 14, 2019 at 7:09:47 PM UTC+2, Abhyudaya Sharma wrote: >>> >>> Hi everyone! >>> >>> I would like to suggest having a Jenkins organization account on >>> SwaggerHub. For the new Folder Auth plugin >>> <https://github.com/jenkinsci/folder-auth-plugin>, I have created a >>> Swagger YAML specification for the plugin's REST APIs. You can check it out >>> here <https://app.swaggerhub.com/apis/abhyudaya/folder-auth/1.0.0>. >>> Having such a specification would help potential users find the APIs (and >>> documentation) without needing to dig deep into the codebase. Also, >>> SwaggerHub can generate stubs in multiple languages for users to easily >>> interact with these APIs. Currently, the specification for the Folder Auth >>> plugin is hosted on my personal account. It would be great to have a >>> Jenkins organization account like on GitHub and have a common store for >>> APIs of all plugins. >>> >>> Thanks >>> Abhyudaya Sharma >>> GitHub: AbhyudayaSharma >>> >> -- >> You received this message because you are subscribed to the Google Groups >> "Jenkins Developers" group. >> To unsubscribe from this group and stop receiving emails from it, send an >> email to jenkinsci-dev+unsubscr...@googlegroups.com. >> To view this discussion on the web visit >> https://groups.google.com/d/msgid/jenkinsci-dev/6764a04d-3d4a-45c2-80fe-1d186fcc0257%40googlegroups.com >> <https://groups.google.com/d/msgid/jenkinsci-dev/6764a04d-3d4a-45c2-80fe-1d186fcc0257%40googlegroups.com?utm_medium=email&utm_source=footer> >> . >> > > > -- > Thanks! > Mark Waite > -- Thanks! Mark Waite -- You received this message because you are subscribed to the Google Groups "Jenkins Developers" group. To unsubscribe from this group and stop receiving emails from it, send an email to jenkinsci-dev+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/jenkinsci-dev/CAO49JtF6o2EisCqudnWbsOpUS5FCBmk28Tq2ZAYF%2BemgU%2BQT9A%40mail.gmail.com.
