Hi Nikhil, In the Swagger implementation, I'm not using Swagger UI files directly, because it's not feasible with the Apache Fineract Backend and there was no direct solution available to integrate it for dynamic documentation, So to counter that I'm using Swagger Core with modifications in the xml files of swagger for generating the Swagger JSON/YAML files which are now supported with the Apache Fineract and then importing the specs files to the Swagger-UI. For the current scenario, the developer has to do the import process manually because we are using Swagger UI separately for UI purpose
https://tech.homeaway.com/development/2016/06/02/ generating-swagger-spec.html Please check for the points 1) Generating Swagger documentation for the REST API and 3) Enabling swagger-ui in the given link and /swagger.json or /swagger,yaml is only accessible when our service is started and the swagger-UI files are static, for now, we need to import it manually for static deployment of the documentation. And for the GCI, As we discussed on our last call I'm thinking of dividing the GCI tasks into 2/3groups (Beginner, Intermediate, Advance) Beginner tasks consist of covering simple endpoints and in the Intermediate Task and Advanced Task for the complex endpoints of the Fineract in which Swagger cannot be integrated directly. I'll share the well-documented Document and also love to interact with DevTeam and community members or students via Video-calls on the usage of Swagger for the dynamic documentation of Apache Fineract with its complete usage and how to use for other API's. Thanks On Sat, Oct 21, 2017 at 4:27 AM, Nikhil Pawar <[email protected]> wrote: > Hello Sanyam,Ed,Nazeer and Avik > > As the annotations for portfolio branch are to be inserted, merging this > PR will not be feasible. > The remaining work can be converted into GCI tasks and once the PR is > completed we can merge it. > > I was also having concern over manually inserting /swagger.json or > /swagger.yml after we have build the application. I am not 100% sure if > this will work, but I have seen people generating the files during compile > time, > https://tech.homeaway.com/development/2016/06/02/ > generating-swagger-spec.html > Although this has been done in maven. > > For bit level task, I can take the lead for mentoring GCI students to get > this PR completed. > > > > Regards, > > Nikhil > > On Wed, Oct 11, 2017 at 7:23 AM, Sanyam Goel <[email protected]> > wrote: > >> Hi, >> >> I have solved the merge conflict with the develop branch. >> >> Thanks, >> >> On Mon, Oct 9, 2017 at 2:29 PM, Sanyam Goel <[email protected]> >> wrote: >> >>> Hi Nikhil, Ed, Nazeer, >>> >>> I'll solve the conflicting files in the PR within this week most >>> probably by Thursday. >>> >>> Thanks, >>> >>> On Sun, Oct 8, 2017 at 1:37 PM, Ed Cable <[email protected]> wrote: >>> >>>> Yes just mentors for now... >>>> >>>> On Sun, Oct 8, 2017 at 12:52 AM, Nikhil Pawar <[email protected]> >>>> wrote: >>>> >>>>> Sure Ed, is the meeting just for mentors? >>>>> >>>>> Regards, >>>>> Nikhil >>>>> >>>>> On Sunday 8 October 2017, 2:47:07 AM GMT-5, Ed Cable < >>>>> [email protected]> wrote: >>>>> >>>>> >>>>> Nikhil, >>>>> >>>>> Could you re-send this sam email to the Apache Fineract dev list so >>>>> this discussion can happen publicly. >>>>> >>>>> As an FYI, we the GSOC mentors have a meeting this Tuesday to do a >>>>> check-in on where all our projects from GSOC stand with merging. >>>>> >>>>> Ed >>>>> >>>>> On Sat, Oct 7, 2017 at 4:09 PM, Nikhil Pawar <[email protected]> >>>>> wrote: >>>>> >>>>> Hi Sanyan, >>>>> >>>>> Hope you are doing well. >>>>> I wanted to start with the review of swagger implementation. >>>>> Could you please correct the conflicting files in the PR. >>>>> In the meanwhile, I am going to clone your PR and start understanding >>>>> its functionality. >>>>> >>>>> >>>>> Regards, >>>>> Nikhil >>>>> >>>>> >>>>> >>>>> >>>>> -- >>>>> *Ed Cable* >>>>> President/CEO, Mifos Initiative >>>>> [email protected] | Skype: edcable | Mobile: +1.484.477.8649 >>>>> <(484)%20477-8649> >>>>> >>>>> *Collectively Creating a World of 3 Billion Maries | *http://mifos.org >>>>> <http://facebook.com/mifos> <http://www.twitter.com/mifos> >>>>> >>>>> >>>> >>>> >>>> -- >>>> *Ed Cable* >>>> President/CEO, Mifos Initiative >>>> [email protected] | Skype: edcable | Mobile: +1.484.477.8649 >>>> <(484)%20477-8649> >>>> >>>> *Collectively Creating a World of 3 Billion Maries | *http://mifos.org >>>> <http://facebook.com/mifos> <http://www.twitter.com/mifos> >>>> >>>> >>> >>> >>> -- >>> SANYAM GOEL >>> LinkedIn: https://goo.gl/6SJMg3 >>> Github: https://goo.gl/u51wRZ >>> Hackerrank: https://goo.gl/4kzLf7 >>> +91-9818060934 <+91%2098180%2060934> >>> >> >> >> >> -- >> SANYAM GOEL >> LinkedIn: https://goo.gl/6SJMg3 >> Github: https://goo.gl/u51wRZ >> Hackerrank: https://goo.gl/4kzLf7 >> +91-9818060934 <+91%2098180%2060934> >> > > -- SANYAM GOEL LinkedIn: https://goo.gl/6SJMg3 Github: https://goo.gl/u51wRZ Hackerrank: https://goo.gl/4kzLf7 +91-9818060934
