Skip to content

Commit

Permalink
docs: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
yudai-nkt committed Aug 12, 2022
1 parent 67d0767 commit 519dceb
Show file tree
Hide file tree
Showing 2 changed files with 54 additions and 0 deletions.
54 changes: 54 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
# gh-form

Don't let malformed issue forms pushed to GitHub

## Overview

gh-form enables you to locally preview [YAML-formatted issue forms](https://docs.github.com/en/communities/using-templates-to-encourage-useful-issues-and-pull-requests/syntax-for-issue-forms) as HTML.
Example below is taken from [TypeScript ESLint](https://github.com/typescript-eslint/typescript-eslint)'s issue template.

![Screenshot of gh-form's preview](./img/preview.png)

## Installation

There are several ways to install gh-form depending on which toolchain you are using.

### GitHub CLI users

gh-form is available as a GitHub CLI extension:

```console
gh extension install yudai-nkt/gh-form
```

### Rustaceans

gh-form is also available on crates.io:

```console
cargo install gh-form
```

### Others

Download a binary from GitHub Releases and put it in your PATH.

## Synopsis

```console
USAGE:
gh-form <SUBCOMMAND>

OPTIONS:
-h, --help Print help information
-V, --version Print version information

SUBCOMMANDS:
help Print this message or the help of the given subcommand(s)
preview Start a local server to preview issue form
```

## License

This repository is licensed under the MIT License.
See [LICENSE.md]() for details.
Binary file added img/preview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 519dceb

Please sign in to comment.