An open API service indexing awesome lists of open source software.

https://github.com/dolanmiu/docsify-sign-off-sheet

Sign-off Sheet for Docsify Documentation
https://github.com/dolanmiu/docsify-sign-off-sheet

Last synced: 3 months ago
JSON representation

Sign-off Sheet for Docsify Documentation

Awesome Lists containing this project

README

          

# docsify-sign-off-sheet 📝

[![](https://data.jsdelivr.com/v1/package/npm/docsify-sign-off-sheet/badge)](https://www.jsdelivr.com/package/npm/docsify-sign-off-sheet)

A docsify plugin to add sign-off sheets to your docs

This plugin is an effort to create relevant, up to date documentation for your project. It is a simple plugin that adds a sign-off sheet to your docs. It is a simple way to ensure that your documentation is up to date and relevant.

It works by setting two items on each documentation page:

1. Review Cadence - How often the documentation should be reviewed
2. Sign-Off Sheet - A list of people who have reviewed the documentation and the respective date it is reviewed at.
3. This plugin will do its magic and create a nice display to show the up to date status of the documentation!

## What is a Sign-Off Sheet?

> A sign-off sheet is a business document that confirms two or more parties agree on the status of a project or goal. Sign-off sheets require signatures from the relevant individuals, or stakeholders, to acknowledge they have both reviewed the matter at hand and are satisfied. Organizations save sign-off sheets as proof that they have fulfilled obligations to employees, other businesses and clients.

It is inspired by the Sign-Off Sheets used by cleaners in restrooms to ensure that the restroom is clean and ready for use.

## Screenshots

What's added:

![](https://i.imgur.com/taFlnNR.png)

When viewing the Sign-Off sheet:

![](https://i.imgur.com/koSVb5G.png)

## Installation

Add the `docsify-sign-off-sheet` plugin to your `index.html` after `docsify`. The plugin is available on `jsdelivr` (below), `unpkg`, and other CDN services that auto-publish `npm packages`.

```html

```

## Usage

1. Create a sign-off sheet block
```markdown


```
2. Add a sign-off cadence. This can be anywhere in the document. But adding it inside the sign-off sheet block is recommended for easy viewing and maintaining.

```markdown
...

...
```

3. Add a table inside the sign-off sheet block. This is where the sign-off sheet will be displayed. This table can be any format you want, this plugin is smart enough to figure it out. The only requirement is that there is a date in each row. The date supports natural language, so write it in any format you wish!

## Example

```markdown

This is the Sign-Off page for the documentation in this repository. Once you have read and understood the documentation, please sign-off by adding your name and date below.

| Name | Date | Notes |
| ----- | --------------- | ---------------------------: |
| Bob | 5th Nov 1999 | Looking all good |
| Alice | 01/31/2000 | Looking fine by me |
| Eve | 2001-06-16 | Looks good to me |
| Ryo | August 4th 2002 | Absolutely fine. Signing off |
| Ryo | 17/08/2003 | No issues, signing off |

```

---

Made with ❤️