Skip to content
This repository was archived by the owner on Feb 2, 2019. It is now read-only.

Commit c9d5cf1

Browse files
committed
add install steps for scrub.sh
1 parent c7b4ef1 commit c9d5cf1

File tree

4 files changed

+24
-50
lines changed

4 files changed

+24
-50
lines changed

.env_SAMPLE

+2
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
export GHE_URL=fake.github.url
2+
echo 'Environment variable GHE_URL set'

README.md

+22-50
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,41 @@
1-
#### CFPB Open Source Project Template Instructions
1+
# Open Source Checklist
22

3-
1. Create a new project.
4-
2. Copy these files into the new project.
5-
3. Update the README, replacing the contents below as prescribed.
6-
4. Add any libraries, assets, or hard dependencies whose source code will be included
7-
in the project's repository to the _Exceptions_ section in the [TERMS](TERMS.md).
8-
- If no exceptions are needed, remove that section from TERMS.
9-
5. If working with an existing code base, answer the questions on the [open source checklist](opensource-checklist.md)
10-
6. Delete these instructions and everything up to the _Project Title_ from the README.
11-
7. Write some great software and tell people about it.
3+
Automating CFPB's [Open Source Checklist](https://github.com/cfpb/open-source-project-template/blob/master/opensource-checklist.md) for easy release of internal source code.
124

13-
> Keep the README fresh! It's the first thing people see and will make the initial impression.
5+
![](https://raw.githubusercontent.com/cfpb/open-source-project-template/master/screenshot.png)
146

15-
----
167

17-
# Project Title
8+
## Dependencies
189

19-
**Description**: Put a meaningful, short, plain-language description of what
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.
10+
- [Node.js](https://nodejs.org/en/)
2311

24-
Other things to include:
12+
## Installation
2513

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.
27-
- **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).
28-
- **Links to production or demo instances**
29-
- 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.
14+
To use [scrub.sh](scrub.sh) to scrub GHE urls:
3015

16+
### Add environment variable
3117

32-
**Screenshot**: If the software has visual components, place a screenshot after the description; e.g.,
18+
1. Copy `[.env_SAMPLE](.env_SAMPLE)` to your project's root.
19+
1. Rename `.env_SAMPLE` to `.env`.
20+
1. Edit `fake.ghe.url` to point to the real GHE url (do not include `https://`).
21+
1. `cd` into your project repo root to activate the new environment variable. You should receive a warning and then a confirmation message:
3322

34-
![](https://raw.githubusercontent.com/cfpb/open-source-project-template/master/screenshot.png)
23+
![](https://raw.githubusercontent.com/cfpb/open-source-project-template/master/screenshot-env.png)
3524

25+
## Configuration
3626

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 known not to work, call that out.
27+
1. step 1
4228

43-
## Installation
44-
45-
Detailed instructions on how to install, configure, and get the project running.
46-
This should be frequently tested to ensure reliability. Alternatively, link to
47-
a separate [INSTALL](INSTALL.md) document.
29+
## Usage
4830

49-
## Configuration
31+
1. In Terminal, from project root, run:
5032

51-
If the software is configurable, describe it in detail, either here or in other documentation to which you link.
33+
```bash
34+
sh ./scrub.sh
35+
```
5236

53-
## Usage
37+
![](https://raw.githubusercontent.com/cfpb/open-source-project-template/master/screenshot-scrub-success.png)
5438

55-
Show users how to use the software.
56-
Be specific.
57-
Use appropriate formatting when showing code snippets.
5839

5940
## How to test the software
6041

@@ -66,20 +47,11 @@ Document any known significant shortcomings with the software.
6647

6748
## Getting help
6849

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-
7350
If you have questions, concerns, bug reports, etc, please file an issue in this repository's Issue Tracker.
7451

7552
## Getting involved
7653

77-
This section should detail why people should get involved and describe key areas you are
78-
currently focusing on; e.g., trying to get feedback on features, fixing certain bugs, building
79-
important pieces, etc.
80-
81-
General instructions on _how_ to contribute should be stated with a link to [CONTRIBUTING](CONTRIBUTING.md).
82-
54+
This software currently has no tests which means it's certainly broken. Want to write bash scripts, node.js modules, break some git histories and probably some other things? [Contributions welcome!](CONTRIBUTING.md)
8355

8456
----
8557

screenshot-env.png

35.3 KB
Loading

screenshot-scrub-success.png

21.9 KB
Loading

0 commit comments

Comments
 (0)