===Project Description( incomplete )===
Many Wikimedia projects and developers use newsletters to broadcast recent developments or any set of relevant news to other Wikimedians. But having to find a newsletter main page out of all the wikis and then subscribing to it by adding your username to a wiki page doesn't really sound appealing. That's when @Qgil thought of centralizing the functions of all newsletters at one place, an idea which later shaped to an extension, Newsletter extension.
>>! In T76199#1073178, @Qgil wrote:
> My only motivation for the centralization is the need to offer a catalog with all the newsletters available in a wiki farm, and the possibility to subscribe/unsubscribe and receive notifications without having to visit or be an active editor of any wiki. If we solve these use cases, then I agree that each wiki community should be able to manage their own newsletters.
===Take a look at our project! ====
So, assuming you are a user who has an account in whichever wiki you are associated with let's start exploring the Newsletter extension. Newsletter extension has three Special pages related to it :
- Special:NewsletterCreate - If you go to Special:SpecialPages, under the 'Other Pages' section there is a link titled 'Create newsletters' which leads you to a special page that helps you to create newsletters. To create a newsletter, you are required to be prepared with a wiki page which will serve as you newsletter's main page and then there are other fields to fill out details of your new newsletter like name of the newsletter, frequency at which issues will be published etc. {F2185047}
- Special:NewsletterManage - If you go to Special:SpecialPages, under the 'Other Pages' section there is a link titled 'Manage newsletters' which leads you to a special page that helps you to manage newsletters owned by you. This page caters as platform to:
- Add publishers - Under the 'Add publishers' section, you can add new publishers( those who can announce issues ) for your newsletters. Only fields required are name of the newsletter and username of the publisher.
- Remove publishers - On this page a table can be seen which gives a detailed view of the newsletters with columns listing the contributors, permissions of the contributors and a column with a 'Remove' button to remove a publisher( Note: Only an owner of a newsletter can remove a publisher of his newsletter )
- Announce new issues - On the same page, under the 'Announce new issue' section you can announce new issues for your newsletters. Just like in 'Create Newsletters', you are required to be prepared with a page which will serve as you issue's main page. Notifications are send to subscribers when an issue is announced.
- Special:Newsletters - If you go to Special:SpecialPages, under the 'Other Pages' section there is a link titled 'Newsletters' which leads you to a page where you can subscribe/unsubscribe to various newsletters. On this page you can see a table which gives you an overview of all the newsletters in the wiki. You can subscribe or unsubscribe from the newsletters just by checking the corresponding radio buttons.
- Missing features/known bugs. Add links to phabricator tasks for the same and leave a short explanation.
- Demo server link
- Resource links (Project in gerrit/github, extension link on wiki etc.)
- Anything else you can think of, which can make contributing to this project easier for newcomers.