Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clean up README.md, made SETUP.md #1274

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,21 @@
# Contribute
# Guide To Contribution

## Introduction

First, thank you for considering contributing to docsify! It's people like you that make the open source community such a great community! 😊

We welcome any type of contribution, not only code. You can help with
We welcome any type of contribution, not only code. You can help with
- **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open)
- **Marketing**: writing blog posts, howto's, printing stickers, ...
- **Community**: presenting the project at meetups, organizing a dedicated meetup for the local community, ...
- **Code**: take a look at the [open issues](issues). Even if you can't write code, commenting on them, showing that you care about a given issue matters. It helps us triage them.
- **Money**: we welcome financial contributions in full transparency on our [open collective](https://opencollective.com/docsify).

## Quick Setup

You can visit this quick [guide on setting up your docsify project locally](https://github.com/docsifyjs/docsify/blob/develop/SETUP.md).


## Your First Contribution

Working on your first Pull Request? You can learn how from this *free* series, [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github).
Expand Down
165 changes: 61 additions & 104 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,19 @@
<!---
Logo
-->
<p align="center">
<a href="https://docsify.js.org">
<img alt="docsify" src="https://github.com/docsifyjs/docsify/blob/develop/docs/_media/icon.svg">
</a>
</p>

<p align="center">
A magical documentation site generator.
<b>Docsify</b>, a magical documentation site generator that has no statically built html files. It is simple and lightweight with a smart full-text search plugin and multiple themes, useful plugin API, compatible with IE11. It also supports both <a href="https://github.com/docsifyjs/docsify-ssr-demo">SSR</a> and embedded files.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sy-records this is good, honestly we need more details because "magical" on the cover doesn't say much. Although I think we might become incompatible with IE11 now, and we shouldn't mention experimental and incomplete/broken SSR support.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't there a description of some Features below? https://docsify.js.org/#/?id=features

</p>

<!---
Badges
-->
<p align="center">
<a href="https://discord.gg/3NwKFyR"><img
alt="Join Discord community and chat about Docsify"
Expand Down Expand Up @@ -36,123 +42,74 @@
/></a>
</p>

<p align="center">Gold Sponsor via <a href="https://opencollective.com/docsify">Open Collective</a></p>

<!---
About, Intro, Contributing
-->
<p align="center">
<a href="https://opencollective.com/docsify/order/3254">
<img src="https://opencollective.com/docsify/tiers/gold-sponsor.svg?avatarHeight=36">
</a>
<h3 align="center">
<a href="https://docsify.js.org/#/quickstart">Quick start</a> &nbsp;·&nbsp;
<a href="https://github.com/docsifyjs/docsify/blob/develop/CONTRIBUTING.md">Introduction</a> &nbsp;·&nbsp;
<a href="https://github.com/docsifyjs/docsify/blob/develop/SETUP.md">Contributing</a> &nbsp;·&nbsp;
<a href="https://github.com/docsifyjs/docsify-cli">CLI</a> &nbsp;·&nbsp;
<a href="https://docsify.js.org/#/deploy">Development Instructions</a> &nbsp;&nbsp;
</h3>
</p>

## Links

- [`develop` branch preview](https://docsifyjs.netlify.com/)
- [Documentation](https://docsify.js.org)
- [CLI](https://github.com/docsifyjs/docsify-cli)
- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify)
- [Awesome docsify](https://github.com/docsifyjs/awesome-docsify)
- [Community chat](https://discord.gg/3NwKFyR)

## Features

- No statically built html files
- Simple and lightweight (~21kB gzipped)
- Smart full-text search plugin
- Multiple themes
- Useful plugin API
- Compatible with IE11
- Support SSR ([example](https://github.com/docsifyjs/docsify-ssr-demo))
- Support embedded files
<!---
Contributors
-->

## Quick start
<h2 align="center">Contributors</h2>

Look at [this tutorial](https://docsify.js.org/#/quickstart)
<p align="center">
<a href="https://github.com/docsifyjs/docsify/graphs/contributors">
<img src="https://opencollective.com/docsify/contributors.svg?width=890" />
</a>
</p>

[![Edit 307qqv236](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/307qqv236)
<!---
Backers
-->
<h2 align="center">Much love to all our backers</h2>
<p align="center">
Be a backer for our awesome project by clicking this <a href="https://opencollective.com/docsify#backers" target="_blank" rel="noopener">link</a>. Thank you to all our backers! 🙏
<a href="https://opencollective.com/docsify#backers" target="_blank">
<img src="https://opencollective.com/docsify/backers.svg?width=890">
</a>
</p>

## Showcase
<!---
Sponsors
-->
<h2 align="center"> Much love to all our sponsors! </h2>

These projects are using docsify to generate their sites. Pull requests welcome :blush:
<p align="justify">
Support this project by donating to our <a href="https://opencollective.com/docsify#silver-sponsors" target="_blank" rel="noopener">OpenCollective</a>. By sponsoring this project your logo will be shown below. The core maintainers and contributors to this open-source project are working mostly in their free time. Thank you so much for your never ending support!
</p>

Move to [awesome-docsify](https://github.com/docsifyjs/awesome-docsify#showcase)
<p align="center">
<a href="https://opencollective.com/docsify/silver-sponsors/0/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/0/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/1/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/1/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/2/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/2/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/3/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/3/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/4/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/4/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/5/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/5/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/6/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/6/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/7/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/7/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/8/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/8/avatar.svg"></a>
</p>

## Similar projects
### Showcase

| Project | Description |
| Links | Description |
| ------------------------------------------------ | ---------------------------------------- |
| [Awesome Docsify](https://github.com/docsifyjs/awesome-docsify) | Awesome things related to [docsify](https://docsify.js.org/). |
| [docute](https://github.com/egoist/docute) | 📜 Effortlessly documentation done right |
| [docpress](https://github.com/docpress/docpress) | Documentation website generator |

## Contributing

### Online one-click setup for Contributing

You can use Gitpod(A free online VS Code-like IDE) for contributing. With single click it'll launch a workspace and automatically:

- clone the docsify repo.
- install the dependencies.
- start `npm run dev`.

So that you can start straight away.

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/docsifyjs/docsify)

- Fork it!
- Create your feature branch: `git checkout -b my-new-feature`
- Commit your changes: `git commit -am 'Add some feature'`
- Push to the branch: `git push origin my-new-feature`
- Submit a pull request

## Development

```bash
npm run bootstrap && npm run dev
```

## Backers

Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/docsify#backers)]

<a href="https://opencollective.com/docsify#backers" target="_blank"><img src="https://opencollective.com/docsify/backers.svg?width=890"></a>

## Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/docsify#silver-sponsors)]

<a href="https://opencollective.com/docsify/silver-sponsors/0/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/0/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/1/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/1/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/2/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/2/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/3/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/3/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/4/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/4/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/5/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/5/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/6/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/6/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/7/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/7/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/8/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/8/avatar.svg"></a>
<a href="https://opencollective.com/docsify/silver-sponsors/9/website" target="_blank"><img src="https://opencollective.com/docsify/silver-sponsors/9/avatar.svg"></a>

## Contributors

This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)].
<a href="https://github.com/docsifyjs/docsify/graphs/contributors"><img src="https://opencollective.com/docsify/contributors.svg?width=890" /></a>

## Status

<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22unit+tests%22"><img
alt="Docsify unit test suite"
title="Docsify unit test suite"
src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/unit tests/develop?label=unit%20tests&cacheSeconds=300"
/></a>
<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22e2e+tests%22"><img
alt="Docsify e2e test suites"
title="Docsify e2e test suites"
src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/e2e tests/develop?label=e2e%20tests&cacheSeconds=300"
/></a>
<a href="https://github.com/docsifyjs/docsify/actions?query=workflow%3A%22lint+checks%22"><img
alt="Docsify linting checks"
title="Docsify linting checks"
src="https://img.shields.io/github/workflow/status/docsifyjs/docsify/lint checks/develop?label=lint%20checks&cacheSeconds=300"
/></a>
| [unpkg](https://unpkg.com/browse/docsify@4.11.4/) | CDN |
| [jsdelivr](https://cdn.jsdelivr.net/npm/docsify/) | CDN |
| [cdnjs](https://cdnjs.com/libraries/docsify) | CDN |

## License

[MIT](LICENSE)
[MIT](LICENSE)
25 changes: 25 additions & 0 deletions SETUP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
### Quick guide for Contributing and Setup

You can use Gitpod(A free online VS Code-like IDE) or CodeSandBox for contributing. With single click it'll launch a workspace and automatically:

- clone the docsify repo.
- install the dependencies.
- start `npm run dev`.

So that you can start straight away.

[![Edit 307qqv236](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/307qqv236)

[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/docsifyjs/docsify)

- Fork it!
- Create your feature branch: `git checkout -b my-new-feature`
- Commit your changes: `git commit -am 'Add some feature'`
- Push to the branch: `git push origin my-new-feature`
- Submit a pull request

## Development

```bash
npm run bootstrap && npm run dev
```