From 193a2adff246555d813c2b50461a9201a44f7429 Mon Sep 17 00:00:00 2001 From: Shane Madden Date: Tue, 27 Aug 2024 17:12:10 -0600 Subject: [PATCH 1/2] Update readme to remove outdated portions --- README.md | 43 +++---------------------------------------- 1 file changed, 3 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index 4e4345c7..887c17c7 100644 --- a/README.md +++ b/README.md @@ -15,57 +15,21 @@ Also the homepage for tools relating to writing [Screeps] AIs in Rust. `screeps-game-api` is a Rust binding to the JavaScript APIs for programs compiled to WASM using [`wasm-pack`]. -Also in this organization is [`cargo screeps`][cargo-screeps], a binary program which wraps -`wasm-pack` and lets one directly upload Rust WASM code to Screeps servers. - -These two tools go together well, but do not depend on eachother. `cargo-screeps` can compile and -upload any screeps WASM project buildable with `wasm-bindgen`'s `wasm-pack`, and `screeps-game-api` is -usable in any project built with `wasm-pack`. +Please see the [screeps-starter-rust example project] for an example project with instructructions +for getting started. Writing Screeps code in Rust can be nice, but it can also be annoying. If you have tips, tricks, or other things you'd like to share, make an issue! We need to write more documentation, and if we have enough ideas, we can start an mdbook for this repository. -- [cargo screeps usage docs][cargo-screeps] -- [screeps-game-api api docs][docs] -- [screeps-starter-rust example project](https://github.com/rustyscreeps/screeps-starter-rust/) - If you need help or want to share feedback, feel free to open an [issue](https://github.com/rustyscreeps/screeps-game-api/issues) or come say "_Hi!_" on [the official Screeps Discord](https://discord.gg/screeps) in the `#rust` channel! ---- - -Here's a quickstart for what you *need* to get going. More documentation will be made in the future. - -```sh -# Install CLI dependency: -cargo install cargo-screeps - -# Clone the starter -git clone https://github.com/rustyscreeps/screeps-starter-rust.git -cd screeps-starter-rust - -# Copy the example config, and set up at least one deployment mode -cp example-screeps.toml screeps.toml -nano screeps.toml -# configure credentials (API key) if you'd like to upload directly, -# or a directory to copy to if you'd prefer to use the game client to deploy - -# build tool: -cargo screeps --help -# compile the module without deploying anywhere -cargo screeps build -# compile plus deploy to the configured 'upload' mode; any section name you -# set up in your screeps.toml for different environments and servers can be used -cargo screeps deploy -m upload -# or if you've set a default mode in your configuration, simply use: -cargo screeps deploy -``` - [screeps]: https://screeps.com/ [`wasm-pack`]: https://rustwasm.github.io/wasm-pack/ +[screeps-starter-rust example project]: https://github.com/rustyscreeps/screeps-starter-rust/ [actions-badge]: https://github.com/rustyscreeps/screeps-game-api/actions/workflows/check.yml/badge.svg [actions-builds]: https://github.com/rustyscreeps/screeps-game-api/actions/workflows/check.yml [cratesio-badge]: https://img.shields.io/crates/v/screeps-game-api.svg @@ -74,5 +38,4 @@ cargo screeps deploy [deps]: https://deps.rs/repo/github/rustyscreeps/screeps-game-api [docsrs-badge]: https://docs.rs/screeps-game-api/badge.svg [docs]: https://docs.rs/screeps-game-api/ -[cargo-screeps]: https://github.com/rustyscreeps/cargo-screeps/ [logo]: ./logo.png From 4b49fd12bce1c013e2935556ee11b687c5e29c80 Mon Sep 17 00:00:00 2001 From: Shane Madden Date: Tue, 27 Aug 2024 17:15:34 -0600 Subject: [PATCH 2/2] tweak wording --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 887c17c7..f88c1b64 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ Also the homepage for tools relating to writing [Screeps] AIs in Rust. `screeps-game-api` is a Rust binding to the JavaScript APIs for programs compiled to WASM using [`wasm-pack`]. -Please see the [screeps-starter-rust example project] for an example project with instructructions -for getting started. +Please see the [screeps-starter-rust example project] for an example with instructructions for +getting started, or the [docs] for a detailed API reference. Writing Screeps code in Rust can be nice, but it can also be annoying. If you have tips, tricks, or other things you'd like to share, make an issue! We need to write more documentation, and if we have