Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The FAQ for API Management is a sub-page of the SAP Graph Troubleshooting #87

Closed
sebastianesch opened this issue Jul 10, 2024 · 4 comments
Assignees
Labels
contribution Valuable Contribution type/content-structure The documentation structure needs to be improved.

Comments

@sebastianesch
Copy link

Issue description

The location of the FAQ Page for API Management under the SAP Graph Monitoring and Troubleshooting page make no sense.

From my point of view, the structure of the Integration Suite Documentation should either be structured Activity > Capability, but at the moment many top level topics should be sorted into the right topics.

E.g.

  • Initial Setup
    • Integration Suite
    • API Mangement
    • Edge Integration Cell
  • ...
  • Monitoring and Troubleshooting
  • Integration Suite
  • API Management
  • SAP Graph

Feedback Type (Optional)

content structure

Page Title on SAP Help Portal (prefilled)

API Management FAQs

Page URL on SAP Help Portal (prefilled)

https://help.sap.com/docs/integration-suite/sap-integration-suite/api-management-faqs

@SrutiSagaram
Copy link

Hi @sebastianesch

Thank you for your feedback. We will check and get back to you.

@Kakabira
Copy link

Hi @sebastianesch: This topic was mistakenly placed under the SAP Graph Monitoring and Troubleshooting page. It has now been corrected.

@Kakabira Kakabira added contribution Valuable Contribution and removed contribution Valuable Contribution labels Jul 10, 2024
@Kakabira Kakabira added the type/content-structure The documentation structure needs to be improved. label Jul 10, 2024
@sebastianesch
Copy link
Author

You have now moved the API Management FAQs out of the SAP Integration Suite documentation. The orginal link forwards to the API Management Documentation. This does not make sense. Either you have a complete documentation for SAP Integration Suite with all Capabilities in one place or you have the overarching Integration Suite Documentation and link to the different capability specific documentations.

The current situation is a mixture of both and very confusing! Especially for people new to SAP and the chaos of putting different old products into new bundles and documentation that cannot keep up with the changes in the software.

@Kakabira
Copy link

@sebastianesch:
We didn't remove the section from the Integration Suite documentation but temporarily hid the content since it was being worked on. We were migrating the guided answers for the "Transport of API Management Artifact" to the FAQs section. The content has now been reviewed and is available on Cloud.
Please see: https://help.sap.com/docs/integration-suite/sap-integration-suite/monitoring-and-troubleshooting-for-api-management?version=CLOUD

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
contribution Valuable Contribution type/content-structure The documentation structure needs to be improved.
Projects
None yet
Development

No branches or pull requests

3 participants