Email Notifications in Fedora Forge

DRAFT DOCUMENTATION: This documentation is currently in draft form and may not be fully tested and correct. Please verify all procedures before use and report any issues or inaccuracies.

Purpose

This document provides guidance on how to enable and configure email notifications in Fedora Forge. Email notifications help you stay informed about activities in repositories and organizations you’re interested in.

Scope

This guide is intended for all Fedora Project contributors and users who want to receive email notifications about repository activities, issues, pull requests, and other events on Fedora Forge.

Important: Email Notifications are Disabled by Default

Email notifications are disabled by default for all users on Fedora Forge. You must explicitly enable them in your user settings if you wish to receive email notifications.

Even if you watch repositories or are a member of an organization, you will not receive any email notifications unless you first enable them in your account settings.

Enabling Email Notifications

To enable email notifications for your Fedora Forge account:

  1. Log into Fedora Forge using your Fedora Account.

  2. Click on your profile picture/icon in the top-right corner.

  3. Select "Settings" from the dropdown menu.

  4. In the left-hand navigation sidebar, click on "Account".

  5. Scroll down to the "Email Notifications" section.

  6. Check the box next to "Enable email notifications".

  7. Click "Update Settings" to save your changes.

After enabling email notifications, you will start receiving emails based on your watching preferences.

How Watching Works with Email Notifications

Once email notifications are enabled, Fedora Forge will send you emails based on what repositories and activities you’re watching. There are several levels of watching:

Watching Individual Repositories

You can watch specific repositories to receive notifications about activities in those repositories:

  1. Navigate to the repository you want to watch.

  2. Click the "Watch" button in the upper right corner of the repository page.

Managing Your Email Notification Preferences

You can control when and how you receive email notifications:

Notification Settings

In your user settings, you can configure:

  1. Enable email notifications: Master toggle to enable or disable all email notifications

  2. Email on my own actions: By default, you won’t receive emails for actions you perform yourself (like commenting on your own issues). Enable this if you want to receive emails for your own actions.

  3. Send all emails to primary email: All notification emails will be sent to your primary email address

Unsubscribing from Specific Threads

If you’re receiving notifications for a specific issue or pull request that you no longer want to follow:

  1. Navigate to the issue or pull request page

  2. Click the "Unsubscribe" button in the sidebar (if you’re currently subscribed)

This will stop notifications for that specific thread without affecting your other watching preferences.

Want to help? Learn how to contribute to Fedora Docs ›