Giter Club home page Giter Club logo

open-source-checklist's Introduction

Open Source Checklist

Automating CFPB's Open Source Checklist for easy release of internal source code.

Dependencies

Installation

To use scrub.sh to scrub GHE urls:

Add environment variable

  1. Add .env and scrub.sh to your project's .gitignore list.
  2. Copy .env_SAMPLE to your project's root.
  3. Rename .env_SAMPLE to .env.
  4. Edit fake.ghe.url to point to the real GHE url (do not include https://).
  5. cd into your project repo root to activate the new environment variable. You should receive a warning and then a confirmation message:

Usage

  1. In Terminal, from project root, run:
./scrub.sh

  1. Force push your repo with tags:
git push <remote> <branch> -f --tags
  1. Remember to tell your collaborators to clone a fresh copy!

Note: If collaborators have branches that they’d like to maintain separately, they will need to fetch and rebase from your updated remote. This must be done via rebase, not merge.

If a collaborator is just mirroring the upstream repo with their fork, they can simply delete their local copy and clone a new one.

Rebase steps

Only use if you must keep a branch that you're working with locally:

git checkout feature-branch
git rebase master

Troubleshooting

If you get the following error when running scrub.sh:

sed: first RE may not be empty

msg filter failed

You did not activate the environment variable for the GHE url. Make sure you update the GHE_URL variable and activate it.

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

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

Getting involved

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!


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 meaningful impact or influence on this project

open-source-checklist's People

Contributors

cfarm avatar

Watchers

Aslam Raffee avatar

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.