Open Documentation Initiative Blog Posts
Get informed about new guides being included in the Open Documentation initiative and new features supporting it.
cancel
Turn on suggestions
Auto-suggest helps you quickly narrow down your search results by suggesting possible matches as you type.
Showing results for 
Search instead for 
Did you mean: 
Read only

The Grand Prix of Developer Feedback

je-hal
Product and Topic Expert
Product and Topic Expert
‎2024 Jul 02 9:43 AM
640

Dear fans of collaboration,

For over twenty-four months, the "SAP Help Portal" team, with their Open Documentation Initiative, has been leading the Formula 1 of developer documentation feedback. Bolstered by the robust support from the "Open Source" pit crew and a well-oiled GitHub collaboration process, it remains the Ferrari of feedback collection, driving continuous improvements on the documentation track. But does every spectator want to be in the Ferrari's driving seat? This season, we're putting that question to the test by introducing a rival racer: The comments feature on SAP Help Portal .

In other words... - results from a survey, but also the amount of feedback we received suggest that GitHub may not be the tool of choice to provide feedback for all roles of SAP BTP. For developers who use GitHub anyway it's a piece of cake to use it for feedback as well, sure, but administrators and especially business users might not be familiar with GitHub at all and hesitant to create an account just for that one purpose. 

For some guides you may have already noticed the following feedback options:

Menus for on SAP Help PortalUsagePrerequisite
Feedback > Create issue
Feedback > Edit page		Provide feedback through GitHub
(guidelines)		You have a personal GitHub account
Feedback > CommentsProvide feedback on SAP Help PortalYou have a user on SAP Help Portal

Comments-and-GitHub.png

 

This year, we'd like to compare the two approaches. And it's all about: measure, measure, measure. The guides below offer both options on SAP Help Portal. The best way to 'vote' for one option is to provide feedback using your most prefered feedback channel. 

RepositoryGuide
btp-best-practices-guideBest Practices for SAP BTP
btp-build-work-zone-advancedSAP Build Work Zone, advanced edition
btp-business-application-studioSAP Business Application Studio
btp-cloud-loggingSAP Cloud Logging
btp-cloud-platformSAP Business Technology Platform
btp-credential-storeSAP Credential Store
btp-developer-guideSAP BTP Developer's Guide
btp-document-management-serviceSAP Document Management Service
btp-document-management-serviceUsing SAP Document Management Service Applications
btp-fiori-toolsSAP Fiori Tools User Guide
btp-identity-authenticationSAP Cloud Identity Services
btp-neo-environmentSAP BTP, Neo Environment
btp-private-link-serviceSAP Private Link Service
cloud-alm-setup-admin-guideSetup and Administration for SAP Cloud ALM
sap-artificial-intelligenceSAP AI Core
sap-artificial-intelligenceSAP AI Launchpad
sap-datasphereAcquiring, Preparing, and Modeling Data with SAP Datasphere
sap-datasphereAdministering SAP Datasphere
sap-datasphereIntegrating Data and Managing Spaces in SAP Datasphere
sap-hana-cloud-data-intelligenceABAP Integration Guide
sap-hana-cloud-data-intelligenceFunction Reference
sap-hana-cloud-data-intelligenceMachine Learning Guide
sap-hana-cloud-data-intelligenceModeling Guide
sap-hana-cloud-data-intelligenceRepository Objects Reference
sap-hana-cloud-data-lakeSAP HANA Cloud, Data Lake SQL Reference for Data Lake Relational Engine
sap-hana-cloud-data-lakeSAP HANA Cloud, Data Lake SQL Reference for Data Lake Relational Engine (SAP HANA DB-Managed)
sap-hana-cloud-hana-databaseSAP HANA Cloud, SAP HANA Database Deployment Infrastructure (HDI) Reference
sap-hana-cloud-hana-databaseSAP HANA Cloud, SAP HANA Database Developer Guide for Cloud Foundry Multitarget Applications (SAP Bu...
sap-hana-cloud-hana-databaseSAP HANA Cloud, SAP HANA Database Developer Guide for Cloud Foundry Multitarget Applications (SAP We...
sap-hana-cloud-hana-databaseSAP HANA Cloud, SAP HANA Database SQL Reference Guide

We're always happy to receive your feedback, no matter through which channel. So it's really up to you if you prefer comments or GitHub. If you have a preference, I'd be interested to understand better why you prefer one or the other. Anyway, thank you for taking part in this race. 

Cheers,
Jens