Skip to content

Commit ad5df80

Browse files
authored
Documentation improvements (CTFd#963)
* Add `SECRET_KEY` instructions to `README.md` for `docker-compose` * Add a basic `CONTRIBUTING.md`
1 parent 95e4060 commit ad5df80

File tree

2 files changed

+25
-4
lines changed

2 files changed

+25
-4
lines changed

CONTRIBUTING.md

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
## How to contribute to CTFd
2+
3+
#### **Did you find a bug?**
4+
5+
* **Do not open up a GitHub issue if the bug is a security vulnerability in CTFd**. Instead [email the details to us at [email protected]](mailto:[email protected]).
6+
7+
* **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/CTFd/CTFd/issues).
8+
9+
* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/CTFd/CTFd/issues/new). Be sure to fill out the issue template with a **title and clear description**, and as much relevant information as possible (e.g. deployment setup, browser version, etc).
10+
11+
#### **Did you write a patch that fixes a bug or implements a new feature?**
12+
13+
* Open a new pull request with the patch.
14+
15+
* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
16+
17+
* Ensure all status checks pass. PR's with test failures will not be merged. PR's with insufficient coverage may be merged depending on the situation.
18+
19+
#### **Did you fix whitespace, format code, or make a purely cosmetic patch?**
20+
21+
Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability of CTFd will generally not be accepted.

README.md

+4-4
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,8 @@ You can use the auto-generated Docker images with the following command:
4848
`docker run -p 8000:8000 -it ctfd/ctfd`
4949

5050
Or you can use Docker Compose with the following command from the source repository:
51-
52-
`docker-compose up`
51+
1. Specify a random `SECRET_KEY` environment variable value in `docker-compose.yml`
52+
2. Run `docker-compose up`
5353

5454
Check out the [wiki](https://github.com/CTFd/CTFd/wiki) for [deployment options](https://github.com/CTFd/CTFd/wiki/Basic-Deployment) and the [Getting Started](https://github.com/CTFd/CTFd/wiki/Getting-Started) guide
5555

@@ -65,9 +65,9 @@ If you prefer commercial support or have a special project, feel free to [contac
6565
Looking to use CTFd but don't want to deal with managing infrastructure? Check out [the CTFd website](https://ctfd.io/) for managed CTFd deployments.
6666

6767
## MajorLeagueCyber
68-
CTFd is heavily integrated with [MajorLeagueCyber](https://majorleaguecyber.org/). MajorLeagueCyber (MLC) is a CTF stats tracker that provides event scheduling, team tracking, and single sign on for events.
68+
CTFd is heavily integrated with [MajorLeagueCyber](https://majorleaguecyber.org/). MajorLeagueCyber (MLC) is a CTF stats tracker that provides event scheduling, team tracking, and single sign on for events.
6969

70-
By registering your CTF event with MajorLeagueCyber users can automatically login, track their individual and team scores, submit writeups, and get notifications of important events.
70+
By registering your CTF event with MajorLeagueCyber users can automatically login, track their individual and team scores, submit writeups, and get notifications of important events.
7171

7272
To integrate with MajorLeagueCyber, simply register an account, create an event, and install the client ID and client secret in the relevant portion in `CTFd/config.py` or in the admin panel:
7373

0 commit comments

Comments
 (0)