2021 June Community Sprint (EMEA)

June 29, 2021

Project Theme

This is an open source and community data collection application solution originally created for a group of health workers in the Himalayan hills around Darjeeling India which is focused on providing affordable field survey capacity to nonprofits worldwide. This team is dedicated to bringing the current iteration of the app to the larger global nonprofit community and is in the process of joining our Open Source Commons program.

Power of Us Hub Group: Community Project: Grassroots Mobile

Sprint Attendees

Team Leader(s): Trish Perkins

GitHub Scribe(s): John Castelloe & Trish Perkins

List of all Contributors:

• Shun Kosaka
• Sena Günay
• Trish Perkins
• John Castelloe

Project Vision This Sprint

John now has a development environment set up on his PC, capable of editing mobile app source code and seeing the app immediately updated in an Android emulator.

One of the plans for this sprint is for Shun to give John a tour of the codebase and explore where he might be able to start contributing on the development side.

The focus will be on improving the user experience and documentation for a Salesforce Admin setting up the app, especially for a non-technical Admin.

Project Team Accomplishments

• Sena, a first-time sprinter, went through the entire app installation and configuration process with an Android phone.
• Trish, John, and Shun followed along and noted some potential adjustments to the process, documentation, and underlying code.
• Shun gave John a tour of the mobile app's codebase and looked for opportunities for him to get acquainted with the code by doing some small fixes.
  • John's feedback on this: Really nice development experience provided by Shun's efforts, great ingredients for a satisfying and productive workflow.
• Everyone discussed options for maintaining the documentation. We made a tentative plan to flesh out the doc on the Github Wiki, incorporating Trish's Screensteps content.
  • The two main target audiences we considered:
    1. A non-technical "Accidental Admin" at a small nonprofit looking for detailed step-by-step instructions.
    2. A more experienced Salesforce Admin looking for concise and streamlined instructions.
  • The two approaches we discussed in terms of doc maintenance:
    1. Providing our own highly detailed content (esp. screenshots) has high maintenance requirements, becoming out-of-date as user interfaces and our own processes change.
    2. Linking to external instructions/tutorials takes advantage of content that is kept up-to-date by other entities, but it forces the reader to jump around to different websites.

Future Contributions (AKA what were you unable to finish at the Sprint)

• John will update the Github wiki to address problems and ideas that came up during Sena's install/config process. Changes will be summarized in a Github Issue. For example:
  • It's better to install the SF package before creating/updating the integration user
  • Shun suggested linking to instructions for installing the APK file on Android
• Trish and John will work together on the setup instructions for SF Admins.
• John will continue learning the development tools and codebase and invite Sena to join in the effort.
• Shun will make the mobile app compatible with a master survey record type (Issue already created).

Other Project Documentation (Not Captured Above)

• N/A