[GitHub] [cordova-docs] janpio opened a new issue #972: Issues with "Android Plugin Development Guide"

[GitBox <gi...@apache.org>]

janpio opened a new issue #972: Issues with "Android Plugin Development Guide"
URL: https://github.com/apache/cordova-docs/issues/972
 
 
   https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html
   
   - First paragraph includes "For another sample, see also the comments in CordovaPlugin.java." which is unclear what comments it refers to (at least to me)
   - Refers twice to "Application Plugins" which is not clear what it refers to (not clickable, not a headline in this document)
   - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#plugin-class-mapping: From "Whether..." this is pretty unclear what it means
     - should also probably include an example of "Java class's fully qualified namespace identifier" (possibly in the context of the sample Echo plugin)
     - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#echo-android-plugin-example later has a full example of this
   - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#writing-an-android-java-plugin
     - What does "The JavaScript exec function's action parameter corresponds to a private class method to dispatch with optional parameters." mean?
       - does this refer to a non-existing (in the example) private `beep` function?
     - What does "When catching exceptions and returning errors, it's important for the sake of clarity that errors returned to JavaScript match Java's exception names as much as possible." mean? Example?
   - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#android-integration What can/should this be used for? Example?
   - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#android-permissions "until recently" to what? 2014?
     - Does this need a headline "Install time permissions"?
       - From how it is formulated right now I don't know if those still exist?
   - https://cordova.apache.org/docs/en/9.x/guide/platforms/android/plugin.html#echo-android-plugin-example is places super awkward in the middle of other types of content

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org