aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorKevin J Hoerr <kjhoerr@protonmail.com>2018-08-31 00:54:19 -0400
committerKevin Hoerr <kjhoerr@submelon.tech>2018-08-31 23:24:45 -0400
commitce68cc32e95a875ee5af40c429c9bbe191997394 (patch)
treebd958d3fb44cd4cc29c7f2a57f0f4390d716eee8 /README.md
parent2463916a5c3f25f3d584aacb8b40130c13619ba1 (diff)
downloadaugust-offensive-ce68cc32e95a875ee5af40c429c9bbe191997394.tar.gz
august-offensive-ce68cc32e95a875ee5af40c429c9bbe191997394.tar.bz2
august-offensive-ce68cc32e95a875ee5af40c429c9bbe191997394.zip
Modify migration files to work seamlessly; update README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md14
1 files changed, 6 insertions, 8 deletions
diff --git a/README.md b/README.md
index 92d7481..c7519b3 100644
--- a/README.md
+++ b/README.md
@@ -5,18 +5,16 @@ August Offensive is a game as a web service that enables players to achieve worl
The main goal of August Offensive is to enable players to interact with the service only when they are available to do so. Effectively, players do not need to maintain connection to the service for the entirety of the game. To prevent games from deadlocking, a customary time limit is enforced (ex. 96 hours).
-## Getting Started
-
-Getting the code running should be fairly simple. Given you have the properly installed packages (PHP 7.0, PostGreSQL 9.6) there should be few if any configuration changes to existing services. Make sure [your credentials are configured](https://github.com/kjhoerr/august-offensive/wiki/Credentials-for-PGSQL) and try visiting /api/callback at your server - you should get a response if it's set up correctly.
+## Technical Objectives
-In order to run tests, install [PHPUnit](https://phpunit.de/) (for PHP 7.0). At the project root, run `phpunit --bootstrap autoload.php test`.
+The project is built using the [Rust programming language](https://www.rust-lang.org/en-US/), [actix-web](https://actix.rs/) as the web framework, and [Diesel](https://diesel.rs/) for interacting with a PostgreSQL database. Diesel and actix-web work on stable Rust, removing the constant need to support nightly features. In addition, Diesel provides a client that makes it easy to migrate between schemas as they evolve between releases. This helps the project maintain a great level of portability without putting too great pressure on the application code.
-## Technical Objectives
+The front-end of this project will be written using [Elm](https://elm-lang.org/) (although this is subject to change). Development on the front-end portion will not begin until August Offensive's web API has reached relative stability. The target version number for stability is 1.0.0.
-The web service will provide a RESTful API that is written in PHP 7.0 and connects to a PostGreSQL database. This connection will be managed behind an abstraction layer using PDO. The service will handle users and their game sessions. In addition, all PHP code shall follow PSR-1, PSR-2, PSR-4, and PSR-5 coding standards. It is also recommended to try to write code as immutably as possible.
+## Deployment
-The front-end of this project will be written using [Elm](http://elm-lang.org/) (although this is subject to change). Work on the front-end portion will not begin until August Offensive's web API has reached relative stability. The target version number for stability is 1.0.0.
+Visit the Wiki for guides detailing [how to deploy August Offensive](https://github.com/kjhoerr/august-offensive/wiki/Deployment) (e.g. standalone or using Docker).
## Contributing to the Project
-While the project is still getting off the ground, there is not much back-end of which to build off. That doesn't mean you can't help brainstorm at least! There is much about the core functionality that is still up in the air at this point. Please have a look at [the Roadmap](https://github.com/kjhoerr/august-offensive/wiki/Roadmap) for a detailed layout of intended features and / or milestones.
+While the project is still getting off the ground, there is not much back-end of which to build off. That doesn't mean you can't help brainstorm at least! There is much about the core functionality that is still up in the air at this point. Please have a look at [the Roadmap](https://github.com/kjhoerr/august-offensive/wiki/Roadmap) for a detailed layout of intended features and / or milestones. \ No newline at end of file