Skip to content

Commit 0e44926

Browse files
committed
remove windows support, update contributing.md
1 parent 177377e commit 0e44926

File tree

3 files changed

+21
-35
lines changed

3 files changed

+21
-35
lines changed

CONTRIBUTING.md

Lines changed: 21 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,25 @@
11
# Contributing to the Unity Web Portal
22

3-
## Branch Structure
4-
5-
Each release version has its own branch. Once that version is released, the branch is locked.
6-
7-
When submitting pull requests, the pull request should be made to the version you are targetting, assuming it is not already released.
8-
93
## Conventions
104

11-
This code base is currently using PHP version 7.4. All files are required to be linted with PSR-12 standard. This repository will automatically check PRs for linting compliance.
5+
This code base is currently using PHP version 8.3.
6+
All files are required to be linted with PSR-12 standard.
7+
This repository will automatically check PRs for linting compliance.
128

139
## Development Environment
1410

1511
### Setting up your Environment
1612

17-
1. Download and install [docker desktop](https://www.docker.com/products/docker-desktop/) for your appropriate OS.
18-
1. In `tools/docker-dev` Run the build script: `./build.sh` (mac os/linux) or `./build.bat` (windows)
19-
1. Run the environment: `./run.sh` (mac os/linux) or `./run.bat` (windows). Press `CTRL+C` to exit.
13+
1. Clone this repo (including submodules): `git clone <this-repo> --recurse-submodules`
14+
1. install composer
15+
1. install PHP dependencies: `composer update`
16+
1. If you're on Windows, use WSL
17+
1. Download and install [docker desktop](https://www.docker.com/products/docker-desktop/)
18+
1. In `tools/docker-dev` Run the build script: `./build.sh`
19+
1. Run the environment: `./run.sh`. Press `CTRL+C` to exit
20+
1. If you bork your LDAP or SQL server, just run `./build.sh` again
21+
1. Install pre-commit
22+
1. setup pre-commit: `pre-commit install`
2023

2124
### Environment Usage
2225

@@ -29,25 +32,14 @@ While the environment is running, the following is accessible:
2932

3033
### Test Users
3134

32-
The test environment ships with a number of users that can be used for testing. When accessing locked down portions of the portal, you will be asked for a username and password. The password is always `password`.
33-
34-
The following users are available for testing:
35-
36-
* `[email protected]` - admin user who is a member of pi_user1_domain_edu
37-
* `[email protected]` - admin user
38-
* `[email protected]` - user who is the owner of pi_user1_domain_edu
39-
* `[email protected]` - user who is the owner of pi_user2_domain_edu
40-
* `[email protected]` - user who is a member of pi_user1_domain_edu
41-
42-
* `[email protected]` - user who is a member of pi_user2_domain_edu
43-
* `[email protected]` - user who is a member of pi_user2_domain_edu
44-
* `[email protected]` - user who has no LDAP object
45-
* `[email protected]` - user who has no LDAP object
46-
* `[email protected]` - user who has no LDAP object
47-
* `[email protected]` - user who is the owner of pi_user1_domain2_edu
48-
49-
* `[email protected]` - user who has no LDAP object
50-
* `[email protected]` - user who has no LDAP object
35+
The test environment ships with a number of users that can be used for testing.
36+
When accessing locked down portions of the portal, you will be asked for a username and password.
37+
The password is always `password`. `tools/docker-dev/web/htpasswd` contains all valid usernames.
38+
39+
Notable users:
40+
* `[email protected]` - admin, PI
41+
* `[email protected]` - not admin, not PI
42+
* `[email protected]` - does not yet have an account
5143

5244
### Changes to Dev Environment
5345

tools/docker-dev/build.bat

Lines changed: 0 additions & 4 deletions
This file was deleted.

tools/docker-dev/run.bat

Lines changed: 0 additions & 2 deletions
This file was deleted.

0 commit comments

Comments
 (0)