PM Spike: Learn and report on website team's usage of DRs

[ryanfchase]

Overview

We need to learn about the website team's Decision Records and document our findings so that we may implement a similar systems in our Wiki and Issues

Action Items

• [x] Create a Google Document within the folder "03 - Product Management" in the shared drive (e.g. Report: Website DR)
• [x] List the types of pages needed to establish a DR Wiki System
  • most likely we'll just need Wiki pages similar to R1.01, R2.01, R3.01, and then pages for each actual DR. Please confirm this is the case.
• [x] For each page determine a requirement for our DR Wiki System:
  • List in the report the general structure of that page (we will be generating a markdown template from these notes)
• [x] Walk through listings in 4.01 and 4.02, note which issues begin with DR:, Decision Record:, or Decision Record For
  • Simply listing them in the report is OK, we will review these as a team
• [ ] ~Add new comment to 311 Data PM agenda: "For upcoming agenda's topic requests: Review website DR report: #1842" (see Resource 5.02)~
  • ~After you've done this, you can move this ticket to In Review, and your work will be complete until feedback is provided~

Resources (R)

1. Wiki: DR Index (All) 1.01 index page
2. Wiki: DR Adopted 2.01 Sub-Index & Template page 2.02 example page
3. Wiki: DR Not Implemented 3.01. Sub-Index & Template 3.02. example page
4. DRs Appearing in Website Team Issues 4.01. Search listing in website repository for "Decision Record" 4.02. Search listing in website repository for "DR"
5. General Info 5.01 What is a spike 5.02 PM Weekly Meeting Agenda 5.03 What is a Decision Record? ⚠️ Not an internal document! (Just for reference)

Hand Off Material

• Link to report requested by Action Items: https://docs.google.com/document/d/1lpbYUZ_p4JEfZCm2UGbEHizqOR8DpuQClzgKb2FjjzI/edit?usp=sharing
• New DR Wiki Pages
  • Index: https://github.com/hackforla/311-data/wiki/Decision-Records
  • Solutions Adopted: https://github.com/hackforla/311-data/wiki/Decision-Records-on-Solutions-Adopted
  • Solutions Not Implemented: https://github.com/hackforla/311-data/wiki/Decision-Records-on-Solutions-Not-Implemented

[ryanfchase]

Prioritizing this and getting ready for pickup.

[londondkim]

ETA: next Friday (10/18).

[ryanfchase]

I wanted to know if other projects were utilizing Decision Records in their wikis. To find this information, I did the following:

1. Went to the Hack for LA main github page: https://github.com/hackforla
2. Typed in the search bar "decision record" (see dropdown below) and clicked the first result: "search in this organization"
3. In the left sidebar, I clicked "More", then Wikis
4. The page then lists all search results in the organization where a wiki page contains the word "decision record"

Screenshot of Search Bar


Screenshot of Sidebar

**More** **Search Results In Wikis**

[londondkim]

https://docs.google.com/document/d/1lpbYUZ_p4JEfZCm2UGbEHizqOR8DpuQClzgKb2FjjzI/edit?usp=sharing

Link to the report made for this ticket Finished

[londondkim]

Reviewed with Ryan Chase + ticket is done