diff options
| author | Fuwn <[email protected]> | 2021-05-15 11:51:40 -0700 |
|---|---|---|
| committer | Fuwn <[email protected]> | 2021-05-15 11:51:40 -0700 |
| commit | 8adf3aec361ac1c4eecb0f86bbffb425d4359245 (patch) | |
| tree | 67cfe899a2a0586d5222d148aaf74ab952f8b309 | |
| parent | Merge pull request #30 from Whirlsplash/renovate/tokio-util-0.x (diff) | |
| download | whirl-8adf3aec361ac1c4eecb0f86bbffb425d4359245.tar.xz whirl-8adf3aec361ac1c4eecb0f86bbffb425d4359245.zip | |
docs(readme): create testing readme in rst
| -rw-r--r-- | .README.rst | 96 |
1 files changed, 96 insertions, 0 deletions
diff --git a/.README.rst b/.README.rst new file mode 100644 index 0000000..75757b8 --- /dev/null +++ b/.README.rst @@ -0,0 +1,96 @@ +.. raw:: html + + <p align="center"> + <a href="https://github.com/Whirlsplash/whirl"> + <img src="https://raw.githubusercontent.com/Whirlsplash/assets/master/Whirl.png" + alt="Whirl" width="220"> + </a> + </p> + <h1 align="center"> + +The Open-Source WorldServer. + +.. raw:: html + + </h1> + + <p align="center"> + +.. image:: https://img.shields.io/discord/821938182274154506 + :alt: Discord + :target: https://discord.com/invite/8hn6padWF6 + +.. image:: https://www.codefactor.io/repository/github/whirlsplash/whirl/badge + :alt: CodeFactor + :target: https://www.codefactor.io/repository/github/whirlsplash/whirl + +.. image:: https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg + :alt: Say Thanks + :target: https://saythanks.io/to/[email protected] + +.. image:: https://img.shields.io/github/license/Whirlsplash/whirl + :alt: License + :target: ./LICENSE + +.. raw:: html + + </p> + +Whirl, an open-source +`WorldServer <http://dev.worlds.net/private/GammaDocs/WorldServer.html>`__ +implementation in `Rust <https://www.rust-lang.org/>`__. + +Purpose +------- + +Two *main* reasons; + +1. Worlds' official servers are old, slowly deteriorating, and *probably unmaintained*. +2. Worlds is **old**. The shutdown of the servers is inevitable. + +TLDR: To keep Worlds' legacy going for future generations. + +Usage +----- + +Use in production environments is not recommended as this project is currently under heavy +development. + +As stability increases, periodic updates regarding production use will be released. + +Documentation +------------- + +https://whirlsplash.org/docs/ + +Known issues +------------ + +- https://github.com/Whirlsplash/whirl/issues/2 + +Contributing +------------ + +Please reference the `contribution guidelines <./CONTRIBUTING.md>`__ of this repository. + +Development Dependencies +------------------------ + +Required +~~~~~~~~ + +- `diesel\_cli <https://crates.io/crates/diesel_cli>`__ +- `cargo-make <https://github.com/sagiegurari/cargo-make>`__ + +Optional +~~~~~~~~ + +- `cargo-watch <https://crates.io/crates/cargo-watch>`__ + +*These development dependencies will automatically be satisfied if you are using the Nix shell +configuration as provided.* + +License +~~~~~~~ + +`GNU General Public License v3.0 <./LICENSE>`__ |