Skip to content

Commit 5c838e7

Browse files
committed
Merge pull request cfpb#8 from marcesher/master
Update README.md
2 parents e555c14 + 106702c commit 5c838e7

File tree

1 file changed

+36
-2
lines changed

1 file changed

+36
-2
lines changed

README.md

Lines changed: 36 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,13 @@
1717
# Project Title
1818

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

2224
Other things to include:
2325

26+
- **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.
2427
- **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](CHANGELOG.md).
2528
- **Links to production or demo instances**
2629
- 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.
@@ -31,12 +34,43 @@ Other things to include:
3134
![](https://raw.githubusercontent.com/cfpb/open-source-project-template/master/screenshot.png)
3235

3336

34-
## How to get this running or how to use it
37+
## Dependencies
38+
39+
Describe any dependencies that must be installed for this software to work.
40+
This includes programming languages, databases or other storage mechanisms, build tools, frameworks, and so forth.
41+
If specific versions of other software are required, or or known not to work, call that out.
42+
43+
## Installation
3544

3645
Detailed instructions on how to install, configure, and get the project running.
3746
This should be frequently tested to ensure reliability. Alternatively, a link to
3847
another page is fine, but it's important that this works.
3948

49+
## Configuration
50+
51+
If the software is configurable, describe it in detail, either here or in other documentation to which you link.
52+
53+
## Usage
54+
55+
Show users how to use the software.
56+
Be specific.
57+
Use appropriate formatting when showing code snippets.
58+
59+
## How to test the software
60+
61+
If the software includes automated tests, detail how to run those tests.
62+
63+
## Known issues
64+
65+
Document any known significant shortcomings with the software.
66+
67+
## Getting help
68+
69+
Instruct users how to get help with this software; this might include links to an issue tracker, wiki, mailing list, etc.
70+
71+
**Example**
72+
73+
If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.
4074

4175
## Getting involved
4276

0 commit comments

Comments
 (0)