[ 
https://issues.apache.org/jira/browse/FINERACT-741?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17039379#comment-17039379
 ] 

Kang Breder Mbulle commented on FINERACT-741:
---------------------------------------------

[~vorburger] Yes, avoiding to add a navigation bar will make it easy for future 
maintainability but this will make the Swagger docs still dependent on the 
older docs because the overview view section of the older docs will not be 
completely copied to the Swagger UI and also it will leave the APIs randomly 
distributed on the UI. We need to come to a conclusion whether to eliminate 
adding the Nav bar. If we put aside that, then I could continue to create PRs 
for the other sub tasks. 

 

I am saying this because adding a nav bar will not require us to use 
swagger-core any longer.

> Improving Swagger UI to group related APIs together instead of random order
> ---------------------------------------------------------------------------
>
>                 Key: FINERACT-741
>                 URL: https://issues.apache.org/jira/browse/FINERACT-741
>             Project: Apache Fineract
>          Issue Type: Sub-task
>            Reporter: Rahul Goel
>            Priority: Minor
>              Labels: fineract-swagger-doc
>
> All API's are currently listed in a random order and someone new to the 
> system cannot comprehend relationships between them. The home page needs to 
> be improved with either a sidebar or a navbar (similar to the one in the 
> existing documentation) which groups together related API's and provides 
> hyperlinks to their swagger documentation



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

Reply via email to