Tracking where are the guides are on CoPs repos and their status

ExperimentsInHonesty commented 3 years ago

Dependency

Once we have closed all the guides that have the label "Cleaup Guide"

Overview

We need to know where the workflow for Guide contributors live for each CoP so that we can standardize the process.

Action Items

[x] Find all the CoP guide management boards (even if they are part of their regular board) and list them in the Resources below
[x] Create a Spreadsheet with a High level overview audit to Identify how the templates and management are different from each other (gold standard is Product)
[x] Draft plan for how they should work
[ ] Provide detailed CoP audit of each CoP, and what needs to change.

Resources/Instructions

audit spreadsheet-WIP

Organizations Google Drive: Hack for LA Guides

List of Community of Practice Guide Management Boards Product Mangement UI/UX Ops - None Admin - None Revenue-Fundraising (No dedicated Guides Board) Revenue-Earned Revenue - None Engineering-Templates and Guides Data Science-Administrative and Project Management Issues (No dedicated Guides board) Marketing-Project Marketing (No dedicated Guides Board)

ExperimentsInHonesty commented 3 years ago

@SheIsBukki Please provide update

Progress
Blockers
Availability
ETA

SheIsBukki commented 3 years ago

Progress: currently working on the second task Blockers: wasn't clear on what to put in the audit spreadsheet. Availability: Wednesday ETA: by next week

Link to the audit spreadsheet

SheIsBukki commented 3 years ago

@ExperimentsInHonesty I've added the links to the guides with unspecified guides labels. You can also check the comments in the spreadsheet for more stuff that need attention.

You can also check this google docs for the different guides label according to each community of practice.

ExperimentsInHonesty commented 3 years ago

I have added another sheet to the Guides Audit to track the new issues created that are just for gathering examples

ExperimentsInHonesty commented 3 years ago

@SheIsBukki will cleanup the Gather Examples tab to make it just for the issues that will be for gathering example, (remove unneeded label columns and clear out the comments part and identify what else might need to be removed.

SheIsBukki commented 3 years ago

Added update to the Leadership Review communication Tracker 16/08/2021

ExperimentsInHonesty commented 3 years ago

@SheIsBukki I have updated the issue status on this [issue](tracker https://github.com/hackforla/UI-UX/issues/43), please update it on the tracker

ExperimentsInHonesty commented 3 years ago

@SheIsBukki Hana got back to us with details about the issues we were trying to sort out in our spreadsheet. We can review next wed https://github.com/hackforla/design-systems/issues/53#issuecomment-900699573

ExperimentsInHonesty commented 3 years ago

This got moved to #43

Requirements for a guide tracking system:

[ ] Accessible by all guide authors to do updates (so that CoP leads don't have to do more work)
[ ] Easy to keep updated
[ ] Either know the status of the issue, or replace issues as a way of tracking the work done on guides
[ ] Encourage Peer review
[ ] Easy to identify which guide issues need leadership review
[ ] Easy to search for guides in progress
[ ] Easy to create new guide issues, and not duplicate
[ ] Identify when published
[ ] Have a way to get suggestions for changes into the pipeline once guides are published
[ ] Differentiate completed guides from the ones in progress
[ ] Prompt/ remind authors of guides in progress and motivate them to complete them
[ ] Clearly lay out each step of the system/process so authors are aware where they are and know what to anticipate
[ ] Straightforward, uncomplicated, and require minimal admin efforts
[ ] Easy to label guides in different categories: product, design, etc
[ ] Information to collect
- [ ] Name of Guide
- [ ] Guide Authors (primary and secondary)
- [ ] Date of creation
- [ ] Which Community of Practice they came out of
- [ ] Who will find them valuable (Development, Design, Project Management, Professional Development, Research)
[ ] Related Templates
[ ] Related Guides (either refer to the other guide or are a part of a larger issue together)
[ ] Status

Current method for tracking guides:

Issues in each repository with label systems
Spreadsheets in some CoPs
Spreadsheet in Guide Team Google Drive
Various Issues in Guides Team repository for tracking guide issues that are non standard

ExperimentsInHonesty commented 3 years ago

This is a copy of the Product Management community of practice tracker with an extra column added to have the name of the CoP https://docs.google.com/spreadsheets/d/1doIUMhwV3k2nUCdVyAEOQ7FiQbCWJAV4TTfuHp9u0Cs/edit#gid=334170522

I am providing this as an example and option. We have not decided to use this.

ExperimentsInHonesty commented 3 years ago

@SheIsBukki @carolzjy think about any other requirements we have for managing the guide workflow through a tracker and add them to the above comment https://github.com/hackforla/guides/issues/2#issuecomment-913707953

hackforla / guides