Skip to content

Workflow Modeling: 1Password (Epic Issue) #21

Open

Description

@kcoronel

Overview

We need to model the workflows of 1Password so that we can create guide making issues.

Action Items

  • Setup Items
    • Check to see if there is a label, and if not create a label for [name of technology] (e.g., 1password, GithHub, Google Drive)
    • Create folder for guides
    • Create folder for recordings
  • Setup complete
    • remove label: "Status: Setup Epic" add label "Status: Make Appt"
  • Make appointment with member of admin team who is currently performing function (see resources).
    • remove label: "Status: Make Appt" add label "Status: Recording Tool Overview"
  • Upload recording and transcripts to its folder.
    • remove label: "Status: Upload Overview" and add label "Status: Identify Workflows"
  • create a list of workflows that will not need guides at this time and define the reason why (decision record).
  • create a list of all workflows that will need guides.
  • create folders inside the guides and recordings folders for each workflow
    • remove label: "Status: Identify workflows - Admin" and add label: "Status: Create Issues from Epic"
    • create issues for each workflow (using the guides creation template).
      • remove label: "Status: Create Issues from Epic" add label: "Status: Monitor Epic" and move to Start Here column
  • once each guide issue is complete and the guide is done, put a link to it in the Guides list below
  • Add this epics label to the tracker. - on hold for now

Resources

Folders

Legend

📁 = Folder
✏️= Transcription
⏺️ = Recording
📝 = "As-Is": Transcript edited down to steps (no pictures, no focus on writing instructions for others)
👷‍♀️ = Draft Guide Take the write up, put it in the Guide template and screen shots (or notes that screen shots are needed) and start working on the language.
🎉= Completed Guide

Workflows that need guides now

Workflows that don't need guides now

Workflow A

Name of Workflow: Travel Option
Decision Record:

  • We are not going to make a tutorial for how to use the Travel Option right now, since we don't see an immediate need.
  • Why we are not using 1Passwords tutorials 📁 ✏️ ⏺️
    • 1password tutorial instructions are
      • too brief, not enough screen shots and helping you get oriented
      • include options that we have already determined that we can't use (so reading them would cause confusion)

Workflow B

Workflow BC

Activity

  1. added
    enhancementNew feature or request
    and removed
    enhancementNew feature or request
    on Oct 9, 2021
  2. changed the title [-]Workflow Modeling: 1Password[/-] [+]Workflow Modeling: 1Password (Epic Issue)[/+] on Oct 9, 2021
  3. ExperimentsInHonesty commented on Nov 14, 2021

    @ExperimentsInHonesty
    Member
    • Fix all the 1password guides so they have the same format. See the following for changes

    • We decided to change where it says
      How to use this Guide?
      to
      How to use this Guide
      Follow the steps listed below.

    • We have to change to use the following convention

    Text or buttons that should be clicked/selected (e.g., Sign-In)
    Choose the Confirm button.

    Text that the user enters word-for-word (e.g., user is instructed to enter xyz into this field)
    Enter "/Remind" into the field

    Text that refers to something on the page
    Their name and email will appear in the Waiting to be Confirmed header.

    • The following text in all the 1password guide files should be formatted as follows
      Head to 1password.com/ and click on Sign In on the top-right hand side. Choose the Hack for LA account. Sign in to the account using your credentials.

    • Use the Search Vaults input box to find the appropriate project title. For this example, we will be using “Test Vault”. From the list returned, select the name of your project.

      • Check name of example in quotes before replacing
  4. kcoronel commented on Dec 18, 2021

    @kcoronel
    MemberAuthor

    The above comment needs to be updated:

    Original: Head to 1password.com/ and click on Sign In on the top-right hand side. Choose the Hack for LA account. Sign in to the account using your credentials.

    Proposed: Head to 1password.com/ and choose Sign in.

    Original: Use the Search Vaults input box to find the appropriate project title. For this example, we will be using “Test Vault”. From the list returned, select the name of your project.

    Proposed:Use the Search Vaults input box to find the appropriate project title. From the list returned, select the name of your project. For this example, we will be using “100 Automations”.

  5. kcoronel commented on Dec 18, 2021

    @kcoronel
    MemberAuthor

    Do I need to add all the guides as links under the guide folder? Yes, at the end, when guide is finalized

      -  🎉[Guide: Add Team Members to 1Password Account Recording](https://docs.google.com/document/d/1wTeCJyYOhDSs5PEOhqJJM2UCX3Nap_mCF1mw8CJEso8/edit?usp=sharing)
      - 🎉 [Guide: Add Team Member to a 1Password Vault Recording](https://docs.google.com/document/d/1Zcx8-_eKZ29zEpwmZhIB8ofhxFkuT9HQl1NKebvAFBo/edit?usp=sharing)
      - 🎉 [Guide: Removing Team Members from a 1Password Vault](https://docs.google.com/document/d/1TK7Y0tLsoeouhH-0fOgmPE2t5WjVD3VrRFSwitZJlhk/edit?usp=sharing)
    

    STILL EDITING:
    - 🎉Add Administrators to 1Password Account
    - 🎉(https://docs.google.com/document/d/1zJSu8wDUMJG3yFV8ipsCFjtDQbZ7fds3--LZNAEPVj0/edit?usp=sharing)
    - 🎉(https://docs.google.com/document/d/1Mg8jAcjJK83xO9c3g0VvB6B5RjpIzPB0W7W8Ozl4qkE/edit?usp=sharing)

  6. ExperimentsInHonesty commented on Dec 18, 2021

    @ExperimentsInHonesty
  7. ExperimentsInHonesty commented on Dec 18, 2021

    @ExperimentsInHonesty
    Member

    notes from 2021-12-18 meeting Edit guide template issue to include a note that says if its the first issue to get worked on in the epic series that you will need to make a template, after you finish writing the guide and copy that template link back into the epic and before starting this issue check the epic to start with the template

  8. ExperimentsInHonesty commented on Jan 15, 2022

    @ExperimentsInHonesty
    Member

    Note from Sept 5th The testing took 15 min per guide
    The editing took 2.75 hours for four guides + notes, however, much of it will be reusable in the other 1password guides

  9. self-assigned this
    on Jan 22, 2022
  10. ExperimentsInHonesty commented on Dec 6, 2022

    @ExperimentsInHonesty
    Member

    When all the 1password guides are done, lets consider publishing something here about it https://discourse.codeforamerica.org/t/managing-2fa-access-for-your-services-across-your-brigade-leadership-team/1225

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions