Food Oasis Documentation Assessment

[staceyrebekahscott]

Overview

Update: 10/18/22

Changing this into a Documentation Epic issue.

Other tasks for Documentation:

• FAQ- to answer questions on process/ procedure
• Role Descriptions (generally)
• Role Descriptions (specific- what tasks do you do that you would need to train someone on if you left the project)
• Transition plan- general checklist for what to train someone on if you were leaving the project.
• Github pages- as a replacement for References/ Wiki and a go to for an overview of the project (maybe a replacement for the Projects page on the HfLA website)
• Create a Bio page for new team members to add a brief bio of themselves. (Maybe something we can add to the main FOLA website at some point.
• List of all software licensing and domain registration used for FOLA. This will be needed for the transition from Code for America to Civic Tech Structure.

Issue on Project Management Board Project Inventory: Food Oasis

#1155 Issue Audit- Folding the scope of this issue into Role Descriptions.

Original Issue Overview/ Scope:
Message from Mark Frischmuth at Democracy Lab: The team at DemocracyLab is performing a documentation review for all of the Impact Sprints projects. As part of this process, we'll prepare a user journey map for each project to help identify opportunities for documentation improvement.

We know that many projects are recruiting new volunteers through DemocracyLab. We'd like to know what other entry points volunteers have to participating in your projects (e.g. Meetup, social media, etc.) and where those volunteers are directed to learn more. This will help us make sound recommendations that are relevant to your project.

Documentation Review Plan

• We'll start with a cursory documentation review of each project to identify patterns of documentation structure.
• In parallel, we'll then:
  • Recommend a model structure for Impact Sprints projects
  • Perform a project-specific gap analysis
• We'll then present to each project recommendations for documentation improvement and additions
• We might then consider following up with:
  • Conduct 30 minute interviews with a series of volunteers, project managers, and future project owners (people who will take ownership once the PMs transition off)
  • Analyze and document themes and insights from interviews
  • Present recommendations for next steps

Action Items

• Contact Mark via CfA Slack DM to arrange access to our Google Drive.
• Meet with Mark and discuss recommendations (Monday, 10/17/22 @ 3:30PM)
• Review "Start Here" Guide and update/ modify for our project.
• See issue Move old shared files to the new HfLA Shared Drive > Food Oasis folder #1087 for task to check Old Google Drive for relevant docs.
• Review all of Move old shared files to the new HfLA Shared Drive > Food Oasis folder #1087 and determine if it can be closed before considering this issue complete.

[staceyrebekahscott]

@itserindean @rylantalerico @yiminng @fancyham @GigiUxR @entrotech Created issue for Documentation Review, sent message to Mark asking who else other than him might need access to our Google Drive.

[staceyrebekahscott]

Granted Mark Viewer access to the FOLA Google Drive.

[staceyrebekahscott]

@itserindean @rylantalerico @yiminng @fancyham @GigiUxR @entrotech Granted Matt Buckingham Viewer access to FOLA Drive. He will be assisting Mark with the Doc review.

[staceyrebekahscott]

I'll be meeting with Mark on Monday, Oct 17 at 3:30PM to get his recommendations.

[staceyrebekahscott]

Notes from Meeting with Mark:

Focus of the doc review was to organize the Drive in order to make it easier for volunteers to on board. He prepared a document for us to use as a "Start Here" guide:

DRAFT Food Oasis Start Here Guide
SAMPLE Democracy Lab Start Here Guide

His reasoning for this guide is because the READ ME in Github is oriented towards developers and is not the most intuitive if you are not a developer.

This "Start Here" Guide should serve as a single source of truth for volunteers joining the project.

Next steps have been added to the Overview section.

Google Drive access for Mark Frischmuth and Matt Buckingham has been removed.