Difference between revisions of "UkHackathon2017"

From Kiwix
Jump to navigation Jump to search
(Added some initial goals. These are open to change. Others are also welcome.)
(Added Testing of Search.)
Line 5: Line 5:


* Effective Logging: to improve testing and troubleshooting. Revise logging in the app to report relevant data that may help with diagnostics, particularly for recent problems including crashes, access to zim files, etc.
* Effective Logging: to improve testing and troubleshooting. Revise logging in the app to report relevant data that may help with diagnostics, particularly for recent problems including crashes, access to zim files, etc.
* Better automated testing: to increase our confidence in the product and make the automated builds and testing more trustworthy and useful. This will include creating additional Mock Objects: Implement the mocks needed for tests that use network operations e.g. download tests.
* Better automated testing: to increase our confidence in the product and make the automated builds and testing more trustworthy and useful. This will include creating additional Mock Objects: Implement the mocks needed for tests that use network operations e.g. download tests. Also, be great to improve the testing of key functionality including searching and results.
* Global Error Handling: Review the initial spike that includes a global error handler and triage whether to use it, do something similar instead, or not bother.
* Global Error Handling: Review the initial spike that includes a global error handler and triage whether to use it, do something similar instead, or not bother.
* Better error detection and error handling in the app: so fewer problems / errors cause the app to crash in use.  
* Better error detection and error handling in the app: so fewer problems / errors cause the app to crash in use.  

Revision as of 14:04, 8 December 2017

Mini Hackathon for Kiwix Android

A mini-hackathon is planned for mid December 2017, hosted by Julian Harty. Dates: 14th and 15th December 2017.

Goals

To address various problems related to the Kiwix Android apps, improve the automated testing and the diagnostic logging. We will also explore whether to add a global exception handler to the app and improve the error reporting to users.

  • Effective Logging: to improve testing and troubleshooting. Revise logging in the app to report relevant data that may help with diagnostics, particularly for recent problems including crashes, access to zim files, etc.
  • Better automated testing: to increase our confidence in the product and make the automated builds and testing more trustworthy and useful. This will include creating additional Mock Objects: Implement the mocks needed for tests that use network operations e.g. download tests. Also, be great to improve the testing of key functionality including searching and results.
  • Global Error Handling: Review the initial spike that includes a global error handler and triage whether to use it, do something similar instead, or not bother.
  • Better error detection and error handling in the app: so fewer problems / errors cause the app to crash in use.
  • Optional Diagnostic Reporting: Explore approaches and methods to collect diagnostic information related to problems users have been reporting. These could be integrated into custom releases of our apps e.g. available on demand. They could be incorporated into one or more mini "diagnostic apps" which we might release as distinct apps. The data transmission and storage would ideally use an automated, established mechanism, rather than creating our own.
  • Ensure our Android apps can be built by Kiwix-Build.

[Good] Practices

Based on our review of the hackathon in Lyon we would prefer to complete smaller concrete tasks rather than open long-running exploratory code branches (many remaining open and untouched since Lyon). Therefore we'd like to commit changes and merge them on a daily basis where practical, and all changes within a week of the hackathon completing.

Participants

  • Elad
  • Isaac
  • Joe
  • Julian

(Others have been invited but not yet responded).

Costs

Minimal for the Kiwix foundation.

Venue

Likely to be at Julian's home. Please contact him julianharty@gmail.com if you'd like to participate and need the address. The current participants have the details.