Contributing guidelines¶
This guide explains how to contribute to the TeleIRC project. It defines working practices of the development team. This document helps new contributors start working on the project. It is a living document and will change. If you think something could be better, please open an issue with your feedback.
Table of contents¶
Set up a development environment¶
Contents:
Requirements¶
To set up a TeleIRC development environment, you need the following:
Create Telegram bot¶
Create a Telegram bot using the Telegram BotFather. See the TeleIRC Quick Start for more instructions on how to do this.
Create Telegram group¶
Create a new Telegram group for testing. Invite the bot user as another member to the group. Configure the Telegram bot to TeleIRC specifications before adding it to the group.
Register IRC channel¶
Registering an IRC channel is encouraged, but optional. At minimum, you need an unused IRC channel to use for testing. Registering the channel gives you additional privileges as a channel operator (e.g. testing NickServ authentication to join private IRC channels). See your IRC network’s documentation on registering a channel.
Configure and run TeleIRC¶
Change the env.example
file to .env
.
Change the configuration values to the Telegram bot’s tokens.
For more help with configuration, see the Config file glossary.
Open a pull request¶
These guidelines help maintainers review new pull requests. Stick to the guidelines for quicker and easier pull request reviews.
We prefer gradual, small changes over sudden, big changes
Write a helpful title for your pull request (if someone reads only one sentence, will they understand your change?)
Address the following questions in your pull request:
What is a short summary of your change?
Why is this change helpful?
Any specific details to consider?
What is the desired outcome of your change?
Maintainer response time¶
Project maintainers make a best effort to respond in 10 days or less to new issues.
Current maintainers are volunteers working on the project, so we try to keep up as best we can.
If more than 10 days passed and you have not received a reply, follow up in Telegram or IRC (#rit-lug-teleirc
on irc.freenode.net).
Someone may have missed your comment – we are not intentionally ignoring anyone.
Remember, using issue templates and answering the above questions in new pull requests reduces the response time from a maintainer to your issue or pull request.