Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Confirm scope of the handbook #82

Open
1 task
danielhonker opened this issue Aug 1, 2023 · 2 comments
Open
1 task

Confirm scope of the handbook #82

danielhonker opened this issue Aug 1, 2023 · 2 comments
Labels
content-revision Updates to substance or meaning governance Relates to our decision making or process for maintaining the handbook priority-low Low priority content to create/publish. Not legally required. Helpful but not necessary for Bloomers

Comments

@danielhonker
Copy link
Contributor

danielhonker commented Aug 1, 2023

Notes on this (will groom the issue)

  • Define scope of what goes in the handbook. What is too specific to one practice area. Concerned about scope creep.

  • Will have some practice-area content -- career growth, competencies -- will be available to everyone.

  • Want to keep the handbook as broad and Bloom-wide as possible. Don't want to have to manage practice-area content.

  • Could also encourage practice areas to have their own mini handbooks for their specific tools, challenges, etc. Publishing those guides will be helpful for teams, and for RFP response.

    • Current examples: PDM guide, Engineering at Bloom
    • Also want a Manager's Guide (but not there yet)
  • Add verbiage to About this Handbook and Contributions to describe the scope

Stories

As a handbook contributor, I want to know what to include in the Handbook, so that I can confidently write and review Handbook content.

As a Bloomer, I want to know what I can expect to find in the Handbook, so that I can look in the right place for stuff.

@danielhonker danielhonker added dev Development-related issues governance Relates to our decision making or process for maintaining the handbook content-revision Updates to substance or meaning and removed dev Development-related issues labels Aug 1, 2023
@coreycaitlin coreycaitlin added the priority-med Med priority content to create/publish. Legally required OR necessary for Bloomers label Nov 28, 2023
@danielhonker
Copy link
Contributor Author

danielhonker commented Jan 9, 2024

There doesn't seem to have been any confusion about what content goes in the handbook vs other docs. As we generate more practice-area or topic-specific guides, more questions might arise. Let's do this sooner so that we head-off questions.
Perhaps we add some language to Contributing to help people understand what goes in the handbook vs other docs.

@coreycaitlin
Copy link
Contributor

Todo: Add section to CONTRIBUTING.md called "what goes in the handbook?" to describe scope, which is "Bloom-wide policy and guidance that can be public."

@coreycaitlin coreycaitlin added priority-low Low priority content to create/publish. Not legally required. Helpful but not necessary for Bloomers and removed priority-med Med priority content to create/publish. Legally required OR necessary for Bloomers labels Apr 16, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
content-revision Updates to substance or meaning governance Relates to our decision making or process for maintaining the handbook priority-low Low priority content to create/publish. Not legally required. Helpful but not necessary for Bloomers
Projects
Status: Groomed and ready
Development

No branches or pull requests

2 participants