Giter VIP home page Giter VIP logo

agile-playbook's Introduction

CFPB Open Source Project Template Instructions

  1. Create a new project.
  2. Copy these files into the new project.
  3. Update the README, replacing the contents below as prescribed.
  4. Add any libraries, assets, or hard dependencies whose source code will be included in the project's repository to the Exceptions section in the TERMS.
  • If no exceptions are needed, remove that section from TERMS.
  1. If working with an existing code base, answer the questions on the open source checklist
  2. Delete these instructions and everything up to the Project Title from the README.
  3. Write some great software and tell people about it.

Keep the README fresh! It's the first thing people see and will make the initial impression.


Project Title

Description: Put a meaningful, short, plain-language description of what this project is trying to accomplish and why it matters. Describe the problem(s) this project solves. Describe how this software can improve the lives of its audience.

Other things to include:

  • Technology stack: Indicate the technological nature of the software, including primary programming language(s) and whether the software is intended as standalone or as a module in a framework or other ecosystem.
  • Status: Alpha, Beta, 1.1, etc. It's OK to write a sentence, too. The goal is to let interested people know where this project is at. This is also a good place to link to the CHANGELOG.
  • Links to production or demo instances
  • Describe what sets this apart from related-projects. Linking to another doc or page is OK if this can't be expressed in a sentence or two.

Screenshot: If the software has visual components, place a screenshot after the description; e.g.,

Dependencies

Describe any dependencies that must be installed for this software to work. This includes programming languages, databases or other storage mechanisms, build tools, frameworks, and so forth. If specific versions of other software are required, or known not to work, call that out.

Installation

Detailed instructions on how to install, configure, and get the project running. This should be frequently tested to ensure reliability. Alternatively, link to a separate INSTALL document.

Configuration

If the software is configurable, describe it in detail, either here or in other documentation to which you link.

Usage

Show users how to use the software. Be specific. Use appropriate formatting when showing code snippets.

How to test the software

If the software includes automated tests, detail how to run those tests.

Known issues

Document any known significant shortcomings with the software.

Getting help

Instruct users how to get help with this software; this might include links to an issue tracker, wiki, mailing list, etc.

Example

If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.

Getting involved

This section should detail why people should get involved and describe key areas you are currently focusing on; e.g., trying to get feedback on features, fixing certain bugs, building important pieces, etc.

General instructions on how to contribute should be stated with a link to CONTRIBUTING.


Open source licensing info

  1. TERMS
  2. LICENSE
  3. CFPB Source Code Policy

Credits and references

  1. Projects that inspired you
  2. Related projects
  3. Books, papers, talks, or other sources that have meaniginful impact or influence on this project

agile-playbook's People

Contributors

anselmbradford avatar contolini avatar marcesher avatar scotchester avatar virtix avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

agile-playbook's Issues

Who is our audience for this playbook?

At our last session on Friday, we discussed identifying our key audience(s). This will help us focus our content and decide what's most important to cover.

Here's just a braindump of possible audiences, not in any particular order:

Internal

  • Dev and design practitioners of agile within the cfpb
  • Product owners / stakeholders / potential collaborators across the bureau
  • New members of the dev and design team who may or may not be familiar with agile

External

  • Other designers and developers in government interested in or currently practicing agile
  • Leadership within other government agencies considering adopting agile
  • Tech-workers in the public interested in how we work
  • Developers and designers who might be interested in working at the cfpb

Who else? Thoughts about which audiences we want to focus on serving (or focus on serving first)?

What questions does our audience have?

We've basically established who our target audience will be (See Issue #2), we should list out questions we think that audience will have so that we can answer them.

Bonus points if you actually go to members of that audience and solicit questions from them! ๐Ÿ’ƒ ๐Ÿ’ƒ ๐Ÿ™

What topics do we want to cover in the playbook?

Brainstorming a list of potential topics to cover, and then prioritizing them based on our audience and goals will help us focus and move quickly!

What topics could we cover? Brainstorm here.

Goal / vision statement for the playbook

Having a unifying vision will help us focus and will align us around a common goal. It will be easier to assess what topics we should include and what content is most important to complete first if we have a single vision to driving our decisions.

We could get real meta and use a retrospective technique at one of our scrum community of practice meetings to collaboratively determine a vision: http://www.funretrospectives.com/defining-the-team-vision-statement/

Or, we could brainstorm here.

Who is our audience for this playbook?

At our last session on Friday, we discussed identifying our key audience(s). This will help us focus our content and decide what's most important to cover.

Here's just a braindump of possible audiences, not in any particular order:

Internal

  • Dev and design practitioners of agile within the cfpb
  • Product owners / stakeholders / potential collaborators across the bureau
  • New members of the dev and design team who may or may not be familiar with agile

External

  • Other designers and developers in government interested in or currently practicing agile
  • Leadership within other government agencies considering adopting agile
  • Tech-workers in the public interested in how we work
  • Developers and designers who might be interested in working at the cfpb

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.