diff options
| author | 2025-12-29 23:04:50 +0000 | |
|---|---|---|
| committer | 2026-04-04 01:37:54 +0100 | |
| commit | cf1a3fd1e4267ec522c10da087262daddc782b20 (patch) | |
| tree | d11b34eafa4301fe08bdf03027cf6ef9e580f189 /README | |
| parent | 2088b61f3d6053d3879dcfcbe91c00157d050e16 (diff) | |
| download | sst-cf1a3fd1e4267ec522c10da087262daddc782b20.tar.gz sst-cf1a3fd1e4267ec522c10da087262daddc782b20.zip | |
Add PatchBot stuff
These are a little different than the ones we were using privately
before and will require some one-off hopefully straightforward
copy-pasting for existing developers. But hopefully this'll remove some
friction from using the thing across the board.
I'd still like to investigate smoother auth methods in the future. The
SSH key idea seems like a good one, but there's some annoying obstacles
there. There's also the idea of having the Discord bot send people
tokens. For now, it's still just manual, which is probably good enough
for quite a long time, to be honest.
This also includes the Sorse Tecknoledgy Committy Discord link, because
I've kind of not done well to advertise the existence of that thing. It
has always been technically open the public, except many people probably
don't know it's there.
Diffstat (limited to 'README')
| -rw-r--r-- | README | 36 |
1 files changed, 36 insertions, 0 deletions
@@ -77,5 +77,41 @@ some console aliases or set up a bind to reload the plugin quickly on-the-fly. Note: some very old (and very new) Source builds don’t have a plugin_load command. For the time being, these versions are unsupported. +════ How to contribute changes ════ + +SST has a somewhat unusual development process. We don’t really take drive-by +changes via the likes of GitHub pull requests or similar, because the project +has very very specific goals and requirements, and also because I find those +workflows annoyingly unwieldy. + +Instead, development takes place in a Discord community known as the Sorse +Tecknoledgy Committy™, which you’re welcome to join: + + https://discord.gg/pC6e7RGQmD + +Do be aware that much of the day-to-day activity there is just rants and memes, +but nonetheless, the best way to get involved in this project is to come and +hang out and talk to people. The #sst-dev channel has plenty of discussion of +what needs done, how to do it, etc. Don’t be shy! Everyone is friendly! + +We have a bot in the Discord called PatchBot which allows Git changes to be +submitted as patch sets, and creates Discord threads for discussion and review. +For convenience, the Git subcommands for working with PatchBot are implemented +inside the SST repository itself. You can use one of the following commands to +set it up for your current terminal session: + + • `tools\patchbot\setup-path.bat` (Windows cmd.exe) + • `. tools/patchbot/setup-path.sh` (Unix-like/POSIX shell) + +This will enable the use of `git grab <number>` to apply a numbered patch series +from a corresponding Discord thread under the #sst-dev channel, as well as +`git submit "description"` to create a new thread from your current WIP. Note +however that the latter requires an authorisation token, both to prevent random +spam and to associate submissions with individuals. Once you’re somewhat +involved in the project I can happily set this up for you. It’s a bit of a +manual process at the moment because there’s nowhere enough people to justify +implementing a proper login system. That’s time that could be spent on SST +itself, or something. + Thanks, and have fun! - Michael Smith <mikesmiffy128@gmail.com> |
