hackforla / hackforla/311-data
PRD - Skills Issue: Dana Martin
- Dominant language
- JavaScript
- Stars
- 73
- Forks
- 74
- PR merge metrics
- No merged PRs in 30d
Description
### Overview
We need to ensure all PMs have access to resources required to manage the 311 Data team, as well as build familiarity with the tools that PMs use on a day-to-day basis
###### TODO: all pictures must be in light mode
### Special Note
Almost every set of Action Items (checkboxes) has dropdowns with more details. Please locate and open them while you work in each section, and you can close them when you advance into the next section
### Table of Contents
Each chapter will explain each platform and the expectations for how to use them.
0. FYI
1. [Slack](#slack)
2. [Github](#github)
3. [Project Board](#project-board)
4. [Markdown](#markdown)
5. [Figma](#figma)
6. [Action Steps Spreadsheets](#action-steps-spreadsheets)
## Section 0: How to use
In this document, we will use...
- bullets
- checkboxes
- dropdowns
- copy/paste blocks
Here are how you can interact with each of them...
- bullets (gif)
- checkboxes (gif + instructions)
- dropdowns (some congratulations for them opening it)
- copy block
###### Desktop and Mobile
- [ ] Download and sign into the Slack desktop application
- [ ] (Recommended) Download and sign into the Slack mobile app
🌐 click to see: Slack download links
> - https://slack.com/downloads/windows
> - https://slack.com/downloads/mac
> - https://slack.com/intl/en-gb/downloads/ios
> - https://slack.com/downloads/android
###### Access to Channels
- [ ] Confirm access to all 311 Data slack channels (see dropdown below)
- [ ] Confirm access to relevant Hack for LA slack channels (see dropdown below)
- [ ] Post in `#311-data` Slack with an intro message
🌐 click to see: Links to Slack Channels
> - 311 Data slack channels
> - [#311-data](https://hackforla.slack.com/archives/CJY4R382X)
> - [#311-data-product-team](https://hackforla.slack.com/archives/C04K46D8FQA)
> - [311-data-leads](https://hackforla.slack.com/archives/C04BFSS3KPC)
> - [#311-data-uiux](https://hackforla.slack.com/archives/CRMBPJ805)
> - Other slack channels
> - [#admin](https://hackforla.slack.com/archives/C01Q24YF56J)
> - [#product-management](https://hackforla.slack.com/archives/C010LNXH2JY)
👋 click to see: Intro message copy/paste block
> ```
> Hi #311-data, my name is X and I've just joined as a Y. My background is in Z. Feel free to connect on linkedin: URL
> ```
###### Notifications
- [ ] For "Notify me about...", choose "All new messages"
- [ ] Select "Notify me about replies to threads I'm following"
- [ ] Notifications > Set Email Notifications: send email for the last hour
📷 click to see: Email notification settings
>
###### Skills Assessment: Slack & Wrap Up
- [ ] Grab the text in this section's copy/paste block and paste it into a new comment on this issue
- [ ] For each question in the copy/paste block, edit the comment to include your answer
- [ ] Complete instructions in "Section wrap-up" drop-down
📝 click to see: Slack Skills Assessment copy/paste block
> ```
> ### Skills Assessment: Slack
> - Q: What is the difference between messages and replies in Slack? When would you use one over the other?
>
>
> - Q: When should you tag someone in a larger slack channel as part of your message, and when should you directly message them?
>
>
> - Q3: What is a "reaction"? What reaction might indicate acknowledgement? If a question is asked, what reaction indicates you are looking into the matter?
>
> ```
🏁 Section Wrap-Up
**Well done getting to the end of the section!** 🎉
We need to get your work reviewed. We have a process for this -- but you'll need to learn how the project board works to do that. For now, please post the following in `#311-data-product-team`. A PM will help clean up this ticket to make it easier for you to track your work.
(note: see next drop-down for instructions on grabbing comment-URLs)
```
Hi #311-data-product-team, I've completed the Slack section of my Skills Issue. Please review my work here:
- https://github.com/hackforla/311-data/issues/2018
- [link-to-slack-skills-assessment-comment]
```
📷 click to see: How to grab a comment's URL
>
###### Initial Setup
- [ ] Add your full name in Github, it should match your name in Slack
- [ ] Set notifications to trigger on mentions and issues you are participating in
📷 click to see: Github notification settings
>
###### Github Project Management Tools: Github Organizations
- [ ] Visit the [Hack for LA Github organization page](https://github.com/hackforla) (note the URL)
- [ ] From there, navigate to Teams > 311-data (aka the read team)
- [ ] From there, navigate to Teams > 311-data-write (aka the write team)
###### Github Project Management Tools: Issues, Labels, Milestones
- [ ] navigate to https://github.com/hackforla/311-data/issues
- [ ] Find and review the [311 Data labels](https://github.com/hackforla/311-data/labels)
- [ ] Find and review the [311 Data milestones](https://github.com/hackforla/311-data/milestones)
- [ ] make them sort it alphanumerically
- [ ] return to the issues tab and observe the searchbar and main controls (see dropdown)
- [ ] From the dropdown menus, practice selecting values from each menu. Observe how this changes the results _AND_ the page URL
- [ ] Skim: [Filtering and searching issues and pull requests](https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests)
- [ ] then do the following tasks...
📷 click to see: Issues tab, highlights
###### Github Project Documentation: Team Wikis
- [ ] Briefly review the [311 Data wiki](https://github.com/hackforla/311-data/wiki)
- [ ] Visit the [Decision Records page](https://github.com/hackforla/311-data/wiki/Decision-Records)
- [ ] Skim [How to Read and Interpret Labels](https://github.com/hackforla/311-data/wiki/How-to-Read-and-Interpret-Labels)
- move this up because it informs the other tasks
- [ ] Skim [How to Create Issues](https://github.com/hackforla/311-data/wiki/How-to-Create-Issues)
###### Github Project Management Tools: Saved Replies
- [ ] Add the copy/paste block in the Saved Reply dropdown to your personal Saved Replies
- [ ] use the saved reply you just created to leave a comment in this issue
📜 click to see: How to find Saved Replies
1. Open the dropdown attached to your profile picture in the top right corner
2. Go to Settings
3. In the left side-bar, find ↩️ Saved replies (bottom of section "Code, planning, and automation")
4. Add the title and body
5. Click "Add saved reply"
📝 click to see: Saved Reply copy/paste block
###### Title
```
Update Request
```
###### Body
```
@github-id
Hi , please provide your weekly update. You can always add more info to the items below 1-4, which are the required minimum.
Instructions
1. Progress: "What is the current status of your project? What have you completed and what is left to do?"
2. Blockers: "Difficulties or errors encountered."
3. Availability: "How much time will you have this week to work on this issue?"
4. ETA: "When do you expect this issue to be completed?"
5. Pictures (if necessary): "Add any pictures that will help illustrate what you are working on."
1. Progress:
2. Blockers:
3. Availability:
4. ETA:
5. Pictures (if necessary):
```
📷 click to see: How to leave a saved reply in a new comment
###### 311 Data Specific Resources
- [ ] Review the FAQ: https://github.com/hackforla/311-data/issues/1878
- [ ] Find the team agendas: general, PM, Product Planning, PM CoP
- [ ] Review: https://github.com/hackforla/311-data/issues/1134
###### Skills Assessment: Github
- [ ] Grab the text in this section's copy/paste block and paste it into a new comment on this issue
- [ ] For each question in the copy/paste block, edit the comment to include your answer
- [ ] Complete instructions in "Section wrap-up" drop-down
📝 click to see: Github Skills Assessment copy/paste block
> ```
> ### Skills Assessment: Github
> - Q: What is a repository? How do you find all repositories for HfLA? Provide links to the repositories for 3 other active projects at HfLA
> - Q: What is a Github Issue template? How can you edit an issue template?
> - Q: When you first open the 311 Data issues tab, what is the significance of `is:issue state:open` in the search bar? What happens when you remove them and hit Enter?
> - Q: What is the difference between a label, and a series-label? What kinds of series-labels do we have on the 311 Data project?
> - Q: What are Milestones? How are they different than labels?
> - Q: Where can you find all of your Github notifications? How do you clear your notifications?
> - Q: Provide a link to the following 311 Data issue searches (open tickets only):
> - all UI/UX tickets that are ready for dev lead
> - all issues authored by team leads
> - all tickets that have an assignee AND the assignee is not the lead PM
> ```
>
🏁 Section Wrap-Up
**Another section down!** 💫
You're doing great, be sure to take breaks and drink water 🌊 Once again, please post the following in `#311-data-product-team`.
```
Hi #311-data-product-team, I've completed the Github section of my Skills Issue. Please review my work here:
- https://github.com/hackforla/311-data/issues/2018
- [link-to-github-skills-assessment-comment]
```
Skills Assessment: Project Board
- Q: What is the relationship between Github Issues and the Project Board?
## Section 4: Markdown
> Rich Text Editing on Github
## Section 6: Action Steps Spreadsheets
### Resources/Instructions
REPLACE THIS TEXT -If there is a website which has documentation that helps with this issue provide the link(s) here.
Contributor guide
Assessment
This issue has not been assessed yet.