...
Ruth Sears-Blazej <rsears@salesforce.com>
...
May 11, 2020, 4:22 PM
...
to Samuel, Christian, Jeff, Pierpaolo, Rachel, xian@pathcheck.org
...
Table of Contents |
---|
Background
Word went out on a Salesforce internal channel that we could use help with documentation (for our github page) from someone with knowledge of the Salesforce platform.
Ruth Sears-Blajez replied offering to help and Sam Zimmerman pointed her at our repositories, early MVP documentation, and some contacts to follow up with (Christian Crumlish Jeff Whatcott.
She got up to speed on our current infrastructure, met with Sam and Rachel Mahan (another Salesforce tech writer) and learned that a top priority is “a guide government IT departments” interested in adopting our open-source code (on a github page). This would explain how to
download and customize your code (for their state or country)
set up the app and a server for themselves
list these apps in the app stores (Apple App Store and Google Play Store)
She also had
fourfive questions:Would these states or countries each be building their own versions of the Safe Paths and Safe Places apps (or building their own apps that depend upon the Safe Paths and/or Safe Places code)? If so, how would end users know which version of the Safe Paths app they should install on their phones?
Would any of the states or countries be using out-of-the-box versions of one or both of the apps? If so, how would people reading the docs decide whether they need to build their own versions or just implement the default versions?
Who would be the best people to work with to hammer out the details about what these government IT people need to know and do?
Also, the Salesforce-internal post that I saw about your looking for writers to help with this project mentioned that you were hoping to find people with knowledge of the Salesforce platform. I didn't see anything about Salesforce in the materials that Sam sent. How does Salesforce's technology fit into the picture?
How soon do you expect to want to publish these docs?
Sam’s answers:
Re: deployment: as it stands now, due to Google and Apple's restrictions on API access:
For the GPS app, we intend for countries to use our app, but they can fork as deploy (at their own risk). The list of HAs supported is contained in our health_authorities.yml file.
For the GPS app the state/nation IT Dept will need to deploy their own server (or work with partners to deploy it).
For BT app, we will need to deploy each app separately for each state/nation. [This is upcoming]
For BT app, we will need to deploy at least two servers for their BT deployment. [This is upcoming]
Who to talk to/hammer out details. Ultimately, Jeff Whatcott (cc'd) as he's just getting up to speed, I added DC Schipps to review too.
Salesforce integration: for now, we’re working out exactly where this next bit, and will update you soon.
Timing: Right now we have rather little by way of materials and are having these conversations multiple times a day, so an MVP or start in the next week would be wonderful, but understand if that's not possible!
...