Skip to content

Commit

Permalink
chore(docs): updates structure and docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Daniel De Lucca authored Apr 17, 2021
1 parent 6f0d0f0 commit 425400d
Show file tree
Hide file tree
Showing 16 changed files with 35 additions and 841 deletions.
9 changes: 0 additions & 9 deletions BUILDING.md

This file was deleted.

128 changes: 0 additions & 128 deletions CODE_OF_CONDUCT.md

This file was deleted.

36 changes: 0 additions & 36 deletions CONTRIBUTING.md

This file was deleted.

21 changes: 0 additions & 21 deletions CUSTOMIZATION_RUNBOOK.md

This file was deleted.

51 changes: 35 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,46 @@
# Customizing your repository
<p align="center">
<br>
<img src="https://media.giphy.com/media/lPcghSeSxVeBl8qtt1/giphy.gif" alt="A scene from Rick and Morty where Morty's head is a planet that is vomiting rainbowns" title="Shell Functions header's GIF" />
<br>
</p>
<p align="center">
Helper functions to use in my custom shell scripts
</p>

After creating a new repository with this template, some files may require proper customization. To do so, please follow these steps:
# Shell Functions

## Prerequisites
* [Why](#why)
* [Quickstart](#quickstart)
* [Usage](#usage)
* [License](#license)

* [gomplate][]
* [tree][]
## Why

## Customization
While coding shell scripts, there are plenty of standard tasks that I need to do. This repository contains modules that can be imported by other scripts.

### Step 1: Define your variables

You can do so by replacing the values inside the `customize.json` file

### Step 2: Run the customization binary
## Quickstart

You can import a given script with the following line:
```sh
./customize
<replace>
```

### Step 3: Enjoy!
This will add all helpers functions from that module to your shell script

## Usage

Each module has it's own usage and functions. Below, I've wrote an one-liner for each module, explaining their general purpose:

* [Feedback][feedback-module]: Functions that give feedback for our user in the CLI, such as logs, spinners, and others
* [Validation][validation-module]: Functions that validate date, throwing errors when they are not valid
* [Authorization][authorization-module]: Functions that handle relevant authorization tasks

## License

Now, your repository is ready to go!
This repository is distributed under the Apache 2.0 License. See [`LICENSE`][license] for more information.

[gomplate]: https://docs.gomplate.ca/installing/
[tree]: https://linux.die.net/man/1/tree
[contributing]: CONTRIBUTING.md
[license]: LICENSE
[feedback-module]: modules/feedback.sh
[validation-module]: modules/validation.sh
[authorization-module]: modules/authorization.sh
47 changes: 0 additions & 47 deletions README_TEMPLATE.md

This file was deleted.

Loading

0 comments on commit 425400d

Please sign in to comment.