ergo/DEVELOPING.md

# Developing Oragono

Most development happens on the `develop` branch, which is occasionally rebased + merged into `master` when it's not incredibly broken. When this happens, the `develop` branch is usually pruned until I feel like making 'unsafe' changes again.

I may also name the branch `develop+feature` if I'm developing multiple, or particularly unstable, features.

The intent is to keep `master` relatively stable.


## Fuzzing and Testing

Fuzzing can be useful. We don't have testing done inside the IRCd itself, but this fuzzer I've written works alright and has helped shake out various bugs: [irc_fuzz.py](https://gist.github.com/DanielOaks/63ae611039cdf591dfa4).

In addition, I've got the beginnings of a stress-tester here which is useful:
https://github.com/DanielOaks/irc-stress-test

As well, there's a decent set of 'tests' here, which I like to run Oragono through now and then:
https://github.com/DanielOaks/irctest
Various crash fixes, and little cleanups for safety 2016-11-04 12:38:47 +01:00			`# Developing Oragono`

developing: Link to more projects 2017-01-12 12:23:46 +01:00			Most development happens on the `develop` branch, which is occasionally rebased + merged into `master` when it's not incredibly broken. When this happens, the `develop` branch is usually pruned until I feel like making 'unsafe' changes again.
Various crash fixes, and little cleanups for safety 2016-11-04 12:38:47 +01:00
developing: Extra note on branch names 2017-01-17 22:30:48 +01:00			I may also name the branch `develop+feature` if I'm developing multiple, or particularly unstable, features.

Various crash fixes, and little cleanups for safety 2016-11-04 12:38:47 +01:00			The intent is to keep `master` relatively stable.


developing: Link to more projects 2017-01-12 12:23:46 +01:00			`## Fuzzing and Testing`
Various crash fixes, and little cleanups for safety 2016-11-04 12:38:47 +01:00
developing: Link to more projects 2017-01-12 12:23:46 +01:00			`Fuzzing can be useful. We don't have testing done inside the IRCd itself, but this fuzzer I've written works alright and has helped shake out various bugs: [irc_fuzz.py](https://gist.github.com/DanielOaks/63ae611039cdf591dfa4).`

			`In addition, I've got the beginnings of a stress-tester here which is useful:`
			`https://github.com/DanielOaks/irc-stress-test`

			`As well, there's a decent set of 'tests' here, which I like to run Oragono through now and then:`
			`https://github.com/DanielOaks/irctest`