Open bradyse opened 1 year ago
@pandanista
When you get to the step where you copy the draft template into a new comment, edit the template with the following issue in mind:
To write instructions on how to change the replace plan number, see the following issue (note where it says RP[Replace 000]
:
For the first action items in the top comment, add user testing notes to the issue below:
For an example, of a resource referenced on the UI/UX CoP, see this wiki page:
name: Research: Transcribe User Interview Recordings
about: The process to transcribe and de-identify interview recordings
title: TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings: Transcribe
labels: 'feature: recording transcription', 'feature: research', 'Participant Type: missing', 'Research 000: missing', 'size: 2pt', 'role: UI/UX research', 'milestone: missing'
assignees:
The person who creates this issue should use links in the section "Resources for creating this issue" (i.e., 1.01, 1.02, etc.) to customize this issue.
[Replace YY]
with research year (Two digit format, ex: "22" for year "2022") [Replace 000]
with the research plan number (Three digit format, ex: "001" for research plan "RP001") [Replace TYPE OF PARTICIPANT]
with the participant type (ex: "Intern" or "Mentor") [Replace TYPE OF INTERVIEW]
with the type of interview (ex: "Intake" or "Exit")TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings: Transcribe
Research: RP[Replace 000]
Participant Type: [Replace TYPE OF PARTICIPANT]
Research 000: missing
and Participant Type: missing
labelsRepository
, and choose Program Management
Research Analysis
milestone: missing
We need to transcribe RP[Replace 000]'s [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] interview recordings so that we can move on to the data analysis and insights generation phase.
During these tasks you will be asked to add link to the Resources/Instructions section, and that section is at the bottom of this issue (go view it now).
Another tip is to use split browser windows side by side when working on any GitHub issue, so you can edit the issue on one window, and check the resources or click through links on the other window to avoid a lot of back and forth. Make sure to refresh both windows to reflect any changes you made, including updating the issue or checking the boxes on one of them.
Customize Resource for Wiki Page Link
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for this Research Plan's Google Drive Folder
[Replace TYPE OF PARTICIPANT]
folder[Replace TYPE OF PARTICIPANT]
folder
[Replace TYPE OF PARTICIPANT]
folder ]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Interview Recordings and Transcriptions Tracking Sheet
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
[Replace TYPE OF PARTICIPANT] Number
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Interview Recording Folder stored in the Internship - PII's My Drive
TWE Interview Recordings by Plan #
folder in Internship - PII's My drive
(Resources # 1.04) TWE Interview Recordings by Plan #
]
and the left parenthesis (
, so it turns into a hyperlinkRP[Replace 000]-UX Researcher Abbreviation###-[Replace TYPE OF PARTICIPANT] Abbreviation###
RP006-U007-I001.txt
, which means this is an interview transcript for research plan 006, conducted by UX Researcher 007, and the interviewee is Intern 001TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Roll Call and Session Table
in RP[Replace 000] folder linked in Resources # 2.02RP[Replace 000] Interview Recording Folder
linked in Resource # 2.04#### Update Interview Recordings and Transcriptions Tracking Sheet
sectionRP[Replace 000]-UX Researcher Abbreviation###-[Replace TYPE OF PARTICIPANT] Abbreviation###
format
RP006-U007-I001.txt
, which means this is an interview transcript for research plan 006, conducted by UX Researcher 007, and the interviewee is Intern 001TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Roll Call and Session Table
in RP[Replace 000] folder in Resources # 2.02RP[Replace 000]-UX Researcher Abbreviation###-[Replace TYPE OF PARTICIPANT] Abbreviation###
format. One is a .mp4 video while the transcript is in .txt.TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Roll Call and Session Table
inside Google Drive Folder: RP[Replace 000]
(Resources # 2.02)[Replace TYPE OF PARTICIPANT]
in the "Session Table" tab of TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Roll Call and Session Table
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Roll Call and Session Table
.RP[Replace 000] Interview Recording Folder
linked in Resource # 2.04Interview Roll Call and Session Table
to see if the missing interview was conducted or not[Replace TYPE OF PARTICIPANT] Number
and the Column B Recording Link
intersectRP[Replace 000] Folder
(Resources # 2.02)
Recording Link
of the Tracking Sheet (Resources # 2.03) Transcription Link
of the Tracking Sheet (Resources # 2.03)RP[Replace 000] De-identified Transcripts
De-identified Interview Transcript-
RP[Replace 000] De-identified Transcripts
folder (Resources # 2.05). This is to make sure that the version history does not include any identifiable information.
Transcription Link - de-identified
(Resources # 2.03)Transcription Link - de-identified
(Resources # 2.03)1.01 Wiki: Research Output Overview 1.02 Google Drive Folder: Research by Type 1.03 TWE: Template: Interview Recordings and Transcriptions Tracking Sheet 1.04* TWE Interview Recordings by Plan # 1.05 1password 1.05.01 Guide: Log into a Google Account with 2-Step Verification Using 1Password If this is your first time logging into Internship's private drive, please follow the instructions to log in. 1.06 Otter.ai
2.01 [Wiki: Research Plan: RP[Replace 000]] 2.02 [Google Drive Folder: RP[Replace 000] 2.03 [TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet] 2.04* [RP[Replace 000] Interview Recording Folder] 2.05 [RP[Replace 000] De-identified Transcripts]
*this folder can only be accessed from the Internship - PII's "My Drive"
name: TWE: Template Issue: Transcribe User Interview Recordings about: The process to transcribe interview recordings title: TWE: IS21: RP001: Intern Interview Recordings: Transcribe labels: 'feature: board / google drive / tools', 'feature: research', 'Research 000: missing' 'size: 1pt', 'role: UI/UX research', 'milestone: missing' assignees:
We need to transcribe the Intern exit interview recordings for further conducting data analysis and insights generation on what the interns experienced during the Internship 2021 Program.
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF INTERVIEW] [Replace TYPE OF PARTICIPANT] Number Spreadsheet
(e.g., TWE: IS21: RP001: Intern Exit Interview Number Spreadsheet)internship@hackforla.org
account[Replace TYPE OF PARTICIPANT] Number
Recording Link
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF INTERVIEW] Transcript: [Replace TYPE OF PARTICIPANT] # 1
1.01 Wiki: Research Output Overview 1.02 Google Drive Folder: Research by Type 1.03 TWE: Template: Generic Spreadsheet 1.04 1password 1.05 Otter.ai
2.01 [Wiki: Research Plan [Replace 000]] 2.02 [Google Drive Folder: RP[Replace 000]] 2.03 [[Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Number Spreadsheet] 2.04 [RP[Replace 000] Interview Recording Folder]
Test assets we are using for this. Bonnie will delete when done.
At some point in our testing, we need access to the intern/number roster so that we can figure out what the process of finding the interviews is (naming of interview recordings was not consistent) TWE: Intern Roster
we left off at
in Column B Recording Link, copy and paste the link to each recording video from Resource # 2.04 for each participant's row
in the part that says
We need to transcribe the [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] interview recordings for further conducting data analysis and insights generation on [Replace TYPE OF PARTICIPANT] [Replace RESEARCH GOALS].
i Just looked at the wiki and the research plan doc for 006 and I am not sure what I would put for RESEARCH GOALS
in the part that says
In Column A [Replace TYPE OF PARTICIPANT] Number, make sure the count of [Replace TYPE OF PARTICIPANT] Number matches with the number of participants in the recording folder, and delete or add extra rows as needed In Column B Recording Link, copy and paste the link of each recording video from Resource # 2.04 for each participant's row
We need to tell them how to read the filename to know which number is the intern #
In the original training deck/interview instructions there is a set of instructions for how to do the upload, which includes what our numbers scheme was
Here is an example file name
At some point we need to tell them to customize the spreadsheet by editing A2 to do the same Search and Replace
lets add a section to the wiki pages for research plans called Recording and Transcription tracking
have an item in the instructions after the sheet is made and populated with the recording links, to
Update the wiki page for this research plan (link # 2.01)
@pandanista I have tested it again with another person and found the issues I mention above.
@ExperimentsInHonesty I have updated everything based on the previous comments, also added a placeholder section (see screenshot below) on the wiki page of RP006 so we can update with the real tracking sheet after it is populated.
Let me know if you have any other questions. Thank you!
I tested Issue #351.
Unclear instructions for renaming video files for RP14 video recordings More comments on the issue.
I tested Issue #351.
Unclear instructions for renaming video files for RP14 video recordings More comments on the issue.
Thank you, Dionne. I went through all the feedback and addressed them in this comment.
@pandanista Issue https://github.com/hackforla/internship/issues/351 will need its template updated after the change is made to address
Dependencies / After second thought, YO decided to leave the dependencies here because: 1. once the issue is created, there is a possibility that there is no assignee, and the UX lead needs to ask the admin of HfLA to add the assignee once decided to the Internship UX vault; 2. we only pay for otter.ai when needed, so UX lead needs to double check on the plan./
Dependency should be
Then it can be retested
Did another round of update on 1/30. All feedback has been incorporated and reflected in the latest template
@pandanista here are the notes from 2023-02-15 PM meeting. I think Kathleen has gone as far as she can. We can discuss these changes at todays's UX meeting
UX lead asks admin to add the team member working on this issue to the 1Password internship-UX's vault
It does not say why
[x] In the Resources gathered during the completion of this issue
section
change
2.04 [RP[Replace 000] Interview Recording Folder]
to
2.04 [RP[Replace 000] Interview Recording Folder*]
Add
*this folder can only be accessed from the internship-ux email account
[ ] We need a dependency on using this issue template that the Responses spreadsheet has been made from the form template. So if the form has not yet been made, the issue can be created, but it has to go into the icebox until the form and its response sheet have been created.
[ ] If we need another email to test something for free in Otter.ai, create an email called TechWorkExperience@gmail.com so that we can test the otter.ai instructions
Additionally, it needs the template edited to a new milestone Research Plan Execution
name: Research: Set Up the Transcription Phase of User Interview about: The process to set up and prepare to transcribe interview recordings title: TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Transcription: Set Up labels: 'feature: recording transcription', 'feature: research', 'Participant Type: missing', 'Research 000: missing', 'size: 0.25 pt', 'role: UI/UX research', 'milestone: missing', 'complexity: small' assignees:
The person who creates this issue should use links in the section "Resources for creating this issue" (i.e., 1.01, 1.02, etc.) to customize this issue.
[Replace YY]
with research year (Two digit format, ex: "22" for year "2022") [Replace 000]
with the research plan number (Three digit format, ex: "001" for research plan "RP001") [Replace TYPE OF PARTICIPANT]
with the participant type (ex: "Intern" or "Mentor") [Replace TYPE OF INTERVIEW]
with the type of interview (ex: "Intake" or "Exit")TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Transcription: Set Up
Research: RP[Replace 000]
Participant Type: [Replace TYPE OF PARTICIPANT]
Research 000: missing
and Participant Type: missing
labelsTWE: Project Board
In Progress
if this issue is actively being worked on. Otherwise, put it in the Prioritized backlog
column Research Analysis
milestone: missing
We need to set up a few spreadsheets and a folder for RP[Replace 000]'s [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] interview transcripts so that we can move on to transcribe the interviews.
During these tasks you will be asked to add link to the Resources/Instructions section, and that section is at the bottom of this issue (go view it now).
Another tip is to use split browser windows side by side when working on any GitHub issue, so you can edit the issue on one window, and check the resources or click through links on the other window to avoid a lot of back and forth. Make sure to refresh both windows to reflect any changes you made, including updating the issue or checking the boxes on one of them.
Customize Resource for Wiki Page Link
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for this Research Plan's Google Drive Folder
[Replace TYPE OF PARTICIPANT]
folder[Replace TYPE OF PARTICIPANT]
folder
[Replace TYPE OF PARTICIPANT]
folder ]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Interview Recordings and Transcriptions Tracking Sheet
[ ] Choose "TWE: Template: Interview Recordings and Transcriptions Tracking Sheet" (Resources # 1.03)
[ ] Choose "USE TEMPLATE" to make a copy of the document
Rename and customize the file by following the steps
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
[Replace TYPE OF PARTICIPANT] Number
[ ] Save the spreadsheet into this Research Plan's Google Drive folder in the Internship's shared drive (Resource # 2.02)
[ ] Choose "Share"
[ ] Choose "Copy link" and "Done"
[ ] In Resources # 2.03, place the link you just copied between parentheses at the end of the line with no space in between the right bracket ]
and the left parenthesis (
, so it turns into a hyperlink
[ ] Choose "Update comment" in Github and make sure all the checkboxes above have been checked
Customize Resource for De-identified Participants List Spreadsheet in the Shared Google Drive to Keep Track of Any Stakeholders Mentioned in Interview Sessions
[ ] Choose "TWE: Template: De-identified Participants List from Interviews (UXR Excluded)" (Resources # 1.04)
[ ] Choose "USE TEMPLATE" to make a copy of the document
Rename and customize the file by following the steps
TWE: IS[Replace YY]: RP[Replace 000]: De-identified Participants List from Interviews (UXR Excluded)
TWE: IS[Replace YY]: RP[Replace 000]: De-identified Participants List from Interviews (UXR Excluded)
[ ] Move the file to RP[Replace 000]'s folder in the shared Google Drive
[ ] Choose "Share" on the top right corner of the spreadsheet
[ ] Choose "Copy link" and "Done"
[ ] In Resources # 2.04, place the link you just copied between parentheses at the end of the line with no space in between the right bracket ]
and the left parenthesis (
, so it turns into a hyperlink
[ ] Choose "Update comment" in Github and make sure all the checkboxes above have been checked
Customize Resource for Interview Recording Folder stored in the Internship - PII's My Drive
TWE Interview Recordings by Plan #
folder in Internship - PII's My drive
(Resources # 1.05) TWE Interview Recordings by Plan #
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Participants List Spreadsheet to Save in the Video Recording Folder for RP[Replace 000] in the Internship - PII's My Drive
TWE: IS[Replace YY]: RP[Replace 000]: Participants List from Interviews (UXR Excluded)
TWE: IS[Replace YY]: RP[Replace 000]: Participants List from Interviews (UXR Excluded)
]
and the left parenthesis (
, so it turns into a hyperlinkRP[Replace 000] De-identified Transcripts
1.01 Wiki: Research Output Overview 1.02 Google Drive Folder: Research by Type 1.03 TWE: Template: Interview Recordings and Transcriptions Tracking Sheet 1.04 TWE: Template: De-identified Participants List from Interviews (UXR Excluded) 1.05* TWE Interview Recordings by Plan # 1.06 TWE: Template: Participants List from Interviews (UXR Excluded)
2.01 [Wiki: Research Plan: RP[Replace 000]] 2.02 [Google Drive Folder: RP[Replace 000] 2.03 [TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet] 2.04 [TWE: IS[Replace YY]: RP[Replace 000]: De-identified Participants List from Interviews (UXR Excluded)] 2.05 [RP[Replace 000] Interview Recording Folder] 2.06 [TWE: IS[Replace YY]: RP[Replace 000]: Participants List from Interviews (UXR Excluded)] 2.07 [RP[Replace 000] De-identified Transcripts]
name: Research: Cleaning Up and De-identifying Interview Transcripts
about: The process to clean up and de-identify interview transcripts
title: TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings: De-identify: [Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER]
labels: 'feature: recording transcription', 'feature: research', 'Participant Type: missing', 'Research 000: missing', 'size: 1pt', 'role: UI/UX research', 'milestone: missing'
assignees:
The person who creates this issue should use links in the section "Resources for creating this issue" (i.e., 1.01, 1.02, etc.) to customize this issue.
[Replace YY]
with research year (Two digit format, ex: "22" for year "2022") [Replace 000]
with the research plan number (Three digit format, ex: "001" for research plan "RP001") [Replace TYPE OF PARTICIPANT]
with the participant type (ex: "Intern" or "Mentor") [Replace TYPE OF INTERVIEW]
with the type of interview (ex: "Intake" or "Exit")[Replace PARTICIPANT NUMBER]
with the number assigned to the participant (Three digit format, ex: "001", and can be found in RP[Replace 000]'s Roll Call and Session Table) TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings: Transcribe: [Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER]
Research: RP[Replace 000]
Participant Type: [Replace TYPE OF PARTICIPANT]
Research 000: missing
and Participant Type: missing
labelsRepository
, and choose Program Management
Research Analysis
milestone: missing
We need to clean up and de-identify RP[Replace 000]'s [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] interview transcripts so that we can move on to the data analysis and insights generation phase.
During these tasks, you will be asked to add links to the Resources/Instructions section, and that section is at the bottom of this issue (go view it now).
Another tip is to use split browser windows side by side when working on any GitHub issue, so you can edit the issue on one window, and check the resources or click through links on the other window to avoid a lot of back and forth. Make sure to refresh both windows to reflect any changes you made, including updating the issue or checking the boxes on one of them.
Customize Resource for Wiki Page Link
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for this Research Plan's Google Drive Folder
[Replace TYPE OF PARTICIPANT]
folder[Replace TYPE OF PARTICIPANT]
folder
[Replace TYPE OF PARTICIPANT]
folder ]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Interview Recordings and Transcriptions Tracking Sheet
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
in the folderTWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for Interview Recording Folder stored in the Internship - PII's My Drive
TWE Interview Recordings by Plan #
folder in Internship - PII's My drive
(Resources # 1.03) TWE Interview Recordings by Plan #
]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resource for the De-identified Transcripts Folder in the Shared Drive
RP[Replace 000] De-identified Transcripts
folder]
and the left parenthesis (
, so it turns into a hyperlinkCustomize Resources for the Recording and Transcript you are Assigned to
De-identify:
TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet
(Resources # 2.03)]
and the left parenthesis (
, so it turns into a hyperlink]
and the left parenthesis (
, so it turns into a hyperlinkTranscription Link
that matches the participant number (Resources # 2.07)Open with Google Docs
To be de-identified-
Copy of
from the file name when the Rename text box pops up]
and the left parenthesis (
, so it turns into a hyperlinkDe-identified Interview Transcript-
RP[Replace 000] De-identified Transcripts
folder. This is to make sure that the version history does not include any identifiable information.
Transcription Link - de-identified
in the tracking sheet (Resources # 2.03)]
and the left parenthesis (
, so it turns into a hyperlink1.01 Wiki: Research Output Overview 1.02 Google Drive Folder: Research by Type 1.03* TWE Interview Recordings by Plan #
2.01 [Wiki: Research Plan: RP[Replace 000]] 2.02 [Google Drive Folder: RP[Replace 000] 2.03 [TWE: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF INTERVIEW] Interview Recordings and Transcriptions Tracking Sheet] 2.04* [RP[Replace 000] Interview Recording Folder] 2.05 [RP[Replace 000] De-identified Transcripts Folder] 2.06 [[Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER] Recording Link] 2.07 [[Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER] Transcript .txt File] 2.08 [[Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER] To be De-identified Transcript Google Doc] 2.09 [[Replace TYPE OF PARTICIPANT] [Replace PARTICIPANT NUMBER] De-identified Transcript Google Doc]
*This folder can only be accessed from the Internship - PII's "My Drive"
The template has been updated, and will be tested by team members when we need to transcribe more interview sessions.
@sunannie27 @KC-skc @ExperimentsInHonesty
Break this into two issues
The parts before and after this bullet
Rename Uploaded Recording Video Files If Needed
The reason for this change is that it would allow us to create the folder structure and tracking spreadsheet at any time after the research plan is approved and the transcription could then be done separately, on an interview by interview basis, if needed.
Sometimes we do a group of interviews at the same time (e.g., intake) Other times we schedule interviews conducted by only a few researchers, over a longer period of time.
This template has been updated by removing the renaming recording files
, transcribing the recordings
, and updating the recording and transcript tracking sheet
sections. However, I decided to keep the Set Up A Folder for De-identified Transcripts in the RP[Replace 000] folder
, Update the Wiki Page
, and Review and Hand-off
sections in this template as they are necessary steps to the set-up phase of the transcription.
Overview
We need to create a template issue for
TWE: Research: Interview Transcription: Set Up
so that we have a consistent, transparent, defined and self-supporting structure for people creating them.Action Items
Customize this issue
TWE: Research: Interview Transcripts: Clean up and De-identify
by using the browser search (Mac: ⌘+F; PC: Ctrl+F)TWE: Role: Direct object: Action verb
Customize the issue settings (located in right sidebar)
Change the issue settings to ensure the issue is properly categorized and easy to manage.
Customize template draft
Create a draft of new template, which will be known as our "draft".
#### Resources for creating this issue
section of your draft#### Resources for creating this issue
section of the draft[TWE: Template Issue: [Role]: [Replace ACTION VERB][Replace DIRECT OBJECT]
If this is for a template draft that needs testing at a later stage, please use the following handoff steps:
feature: template creation (step 1)
to this issueResources/Instructions
Resources for creating this issue
Instructions for creating this issue
The person who creates this issue should use these links to add links to the resources section and customize this issue
[Replace
Dependencies
Overview
We need to [Replace ACTION VERB] [Replace DIRECT OBJECT] for [Replace REASON].
Action Items
A STEP BY STEP LIST OF ALL THE TASK ITEMS THAT YOU CAN THINK OF NOW EXAMPLES INCLUDE: Research, reporting, coding, etc.
Resources
Resources for creating this issue
Resources gathered during the completion of this issue
2.01
2.02
1.02 Front Matter Resources
Front Matter Fields and Meaning
- name: (name that appear on the new issue tab) - about: (is the description that appears next to the issue template on the new issue tab) - title: (the title that appears when the issue is created. User then customizes this title for their issue) - Use the naming convention: TWE: Role: Direct object: Action verb - If more than one word should go into the direct object spot, use multiple square brackets with the keyword (see example below) - labels: (choose the labels that will be the same each time, and choose missing labels for the ones that depend on content) - assignees:Front Matter Field Example
- name: 'TWE: Template Issue: Research: Create Roadmap' - about: This issue helps you structure your template issue to be consistent with our other template issues in roadmap - title: 'TWE: Research: IS[Replace YY]: RP[Replace 000]: [Replace TYPE OF PARTICIPANT] [Replace TYPE OF RESEARCH METHOD]: Roadmap : Create' - labels: 'feature: research', 'feature: roadmap', 'milestone: missing', 'role: UI/UX research', 'Participant Type: missing', 'Research 000: missing', 'complexity: missing' - 'size: 0.50pt' - assignees: ''1.03 Example Action Items for Finding Wiki Page and Template
Example Action Items
``` ### Action Items - Customize wiki page - [ ] Go to link 1.01 Internship Wiki, Join the team page - [ ] Find wiki page for this issue by looking at role pages. - [ ] Copy the link for the wiki page. - [ ] Add the link to Resource 2.01 - [ ] Add the name of the link in square brackets - [ ] Add the URL in parenthesis without a space between the square bracket and parenthesis - Customize document template. - [ ] Go to link 1.02 Design Process Overview - [ ] Find document template that should be used in this issue. - [ ] Copy the link for the template. - [ ] Add the link to Resource 2.02 - [ ] Add the name of the link in square brackets - [ ] Add the URL in parenthesis without a space between the square bracket and parenthesis ```Example Resource Lists
``` ### Resources for creating this issue - 1.01. [Internship Wiki, Join the team page](https://github.com/hackforla/internship/wiki/Joining-the-Team) - 1.02. [Design Process Overview](https://github.com/hackforla/internship/wiki/Design-Process-Overview) ### Resource links gathered during the making of this issue - 2.01. [Wiki page for [Replace TYPE OF ROLE]] - 2.02. [TWE: Template: [Replace NAME OF TEMPLATE]] ```1.04 WIKI Templates by role pages
Resources gathered during the completion of this issue