We've been testing the Apigee Gateway and the developer portal for about three weeks. These are my thoughts regarding the developer portal. I'd love to know what some people think about some of the trade offs / limitations in the functionality that I've run into and how you deal with it.
Dear @José Cedeño ,
Great thoughts and awesome feedback. Please find my opinion on same. I am sure others will have better opinions and look forward to hear.
Yes, Drupal is a powerful CMS and industry proven platform to build Developer Portal experiences. You can do N number of things using Drupal CMS with the power of contributed modules & community. Like Twitter, LinkedIn, EBay developer portals Apigee Developer Portal distribution is also built using Drupal CMS. It's easy to customise experience & introduce new workflows within a short time using powerful Drupal APIs & Custom Modules. It may require Drupal Experience sometimes.
Yes, Agree. Its confusing & not a great experience when you edit nodes whereas source of your smartdocs docs is swagger or wadl. Ideally, We should have capability of swagger editor in built into Developer Portal. We will take it as a feature request.
Agree, API Proxies / API Products / Permissions is not tied to SmartDocs & both currently work independently. Ideally, We should have defined once & reuse at multiple places. Like you upload swagger spec - Create API Proxies, Generate SmartDocs, Map Permissions. Hopefully feature versions of smartdocs will have it as a configurable options where we can pull the values from Apigee Edge.
Yes, API Products & Smart Docs categories are not mapped. You need to manually do it in developer portal. If you are looking to restricting smartdocs in developer portal, You can restrict visibility based on Drupal Node Permissions using modules like Content Access. Its a temporary work around that we can suggest for now.
It can be achieved in Developer Portal by implementing custom modules & workflows. We have implemented same for many customers as part of customisations. Agree, there should be a way to define dev API Products vs Live API Products in developer portal as well as edge. It should be available as out of the box feature in Developer Portal. We will take it as a feature request.
I believe smart docs provides this default configuration. @sgilson @Gitesh Koli @seshi Any Idea ?
Yes, It's due to default forum module. You can use Advanced Forum module or customise it to change look & feel. See one of our customer portal forums using Advance Forum & custom css here.
Agree, Great Feedback. We will take it as a feature request and let our team know about it.
It can be built as a custom feature. But, there are couple of questions like do you create a new app ? add api product to existing app ? It depends on requirements of customer who is implementing it.
You can also upload multiple swagger files & generate multiple smartdocs respectively.
We really appreciate taking your time to share very valuable feedback. It's really helpful for us.
Cheers,
Anil Sagar
@Anil Sagar thanks for the detailed response. Your thinking helps clarify my thoughts and validate some of the issues that we ran into. Is there a way to see what are the known bugs in Apigee Edge and Developer Portal as well as what's being worked on for the next release?
@José Cedeño , Unfortunately they are not accessible publicly. But you can always find what's new in our Developer portal release notes here. We will update this thread if any one of above issues are fixed in our future releases.
User | Count |
---|---|
1 | |
1 | |
1 | |
1 | |
1 |