brodybits opened a new issue #1057: RFP update and overhaul cordova-docs
URL: https://github.com/apache/cordova-docs/issues/1057
 
 
   My understanding from Apache Cordova PMC discussions is that an anonymous 
donation was received for the purpose of improving our documentation. I think 
it should be enough to cover multiple months of full-time work if we can source 
the work in a strategically intelligent manner.
   
   Issues have been piling up over the years. I would really like to see some 
things happen in the near future such as:
   
   - review of all existing documentation to check for resolve items such as 
incorrect information, missing information, and any possible lack of clarity
   - get automatic doc build working again (#1035)
   - add tutorials and guides for some common tasks such as:
     - using Cordova with tools such as Babel, Rollup, and Webpack
     - integration with some larger frameworks such as Angular, Vue, Preact, 
React, and Ionic
     - authoring plugins for Android, iOS, and Electron
   - upgrade to use a super-modern documentation system such as Gatsby, JSDoc, 
etc.
   - go through the [open 
issues](https://github.com/apache/cordova-docs/issues) and get them down to a 
handful at the most (let's get them fixed please, avoid some other outcomes 
such as "invalid" or "won't fix")
   
   It would be ideal if we could find a maintainer or similar kind of Cordova 
expert as well as a well-qualified technical editor who would have the time to 
do this kind of update and overhaul in the near future.
   
   I would also very strongly favor an agile approach where we start with tasks 
of limited scope and limited cost. I really hope we can start to see some 
positive impact before burning too much of the budget.
   
   /cc @DRuggeri

----------------------------------------------------------------
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:
[email protected]


With regards,
Apache Git Services

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to