Contributing to Fedora can be a complex undertaking. The large number of systems to interact with on daily basis means having to check multiple different web applications to complete a task or track tickets. For new contributors, knowing where to look for information about a task across the large number of tools to interact with is daunting.
Fedora Hubs will to provide a communication and collaboration centre for Fedora contributors of all types. Current contributors will visit Hubs to check on their involvements across Fedora, discover new teams that they can contribute with. For new contributors, Hubs is a place to get started collaborating with others.
Timetable
Hubs will be released as version 1.0 by .
(The date likely needs to be ratified by the team. But given our date now, it would make sense to try and target Q4FY18, maybe 2018-Feb-01? --pfrields (talk) 14:17, 10 November 2017 (UTC))
Functionality Description
The following is the list of functionality that needs to be completed to consider Fedora Hubs a Minimal Viable Product (MVP) -- which will be released as Fedora Hubs 1.0
Core
- Fedora Hubs will allow a user to log into using FAS
- The majority of functionality in Fedora Hubs will only be visible to users logged in with a FAS account
- When not logged in, a user will be greeted with a frontpage that describes hubs, and either lets them log in or sign up for an account in FAS.
- Fedora Hubs will have a basic global search that lets a user search for group hubs and user hubs
- Fedora Hubs will have a sidebar that lists links and bookmarks tailored to that user including:
- My Hub -- a link to the logged in user's hub
- My Stream -- a link to the user's stream page
- All Groups -- a link to the global page that lists all the groups hubs on Fedora hubs
- A list of links to group and user hubs that a user has starred
- a list of links to group hubs that the user is a member of (excluding their own hub, and hubs that have been starred, as they will be presented eariler in the list)
- a list of links to group and user hubs that a user is subscribed to (excluding hubs that the user is a member of, or have starred, as they will be presented eariler in the list)
Personal Hub
A personal hub provides a place for a Fedora contributor to display details about their fedora account, as well as status of tasks they are working on.
Personal Hub topbar
- the topbar contains the ability for a user can star another users hub. Starring a hub makes the hub show in the starred section at in the left hand bookmarks menu.
- the topbar contains the ability for a user can subscribe to another users hub. Subscribing to a user's hub makes messages about the user's actions show up in your stream.
- the user hub can be configured by the user in hubs to change their Full Name, and their bio. These details are displayed in the topbar of all user hubs.
- a user's hub displays contact details of a user in the topbar of the hub for all user hubs. these contact details are not editable in hubs, and are pulled from FAS. These details are: Location, Current Time, email address, IRC nick, and how long the user has been a FAS account holder.
- the topbar also contains stats on the number of subscribers the user has, as well as how many hubs the user is subscribed to.
Widgets
A user hub contains a fully configurable area for a user to display widgets that provide information about themselves or the work they are currently doing in Fedora.
The following widgets are available on a Personal Hub:
- Feed -- a list of the most recent actions that the user has done in Fedora
- Subscribers -- a list of the other users that subscribe to this user hub
- Library -- a user configurable list of links to resources they find useful
- Weekly Activity -- a graph of the user's acitvity on fedora systems over the past week.
- Help Requests -- a widget that shows open help requests on a user-defined list of Group hubs
- Sticky Note -- a freeform widget where a user can present some text to visitors to their hubs. Rendered html from markdown.
- My Hubs -- the list of group hubs that the user is a member of, or subscribed to
- My Assigned Issues - a list of the issues that are assigned to the user in bugzilla, pagure, and github
- Newest Opened Pull Requests a list of the newest opened pull requests for a repo defined by the user in the widget config. It can either a be a pagure repo or a github repo or a github org
- Newest Opened Issues a list of the newest opened issues for a repo defined by the user in the widget config. It can either a be a pagure repo or a github repo or a github org
Team Hub
- Fedora Hubs will create a place for a team to display their details (goals of the team, meeting details, etc) so other users view them.
- Fedora Hubs will provide a configurable place for a team to view the status of tasks they are currently performing on different Fedora Applications.
- Fedora Hubs will provide a way for a user to subscribe to a team hub to (Question -- why? and how is this different to joining)
** I expect this would keep you from being listed in a Hub roster of people, but still see team work or updates in your feed. Might be useful for people who lead teams or provide oversight. --pfrields (talk) 14:20, 10 November 2017 (UTC)
- Fedora Hubs will provide a way for a user to join a team hub
- Fedora Hubs will allow a user to be an admin of a group hub
- Fedora Hubs will allow the admin of a hub to change settings of a team hub
Browse Hubs
- Fedora Hubs will provide way for users to browse for Team Hubs and People (Personal Hubs)
My Streams
Not sure what this is.
(Is this a feed of items from subscribed hubs/teams? --pfrields (talk) 14:16, 10 November 2017 (UTC))
Scoping
Here is where we define in detail the features / widgets / items that need to be in (and working properly) Fedora Hubs for us to consider it 1.0
Core
Widgets
Feed
Group Widget User Widget
The feed widget shows a chronological list of notifications about actions that have occurred across Fedora Applications.
- The user feed widget shows actions for all group hubs the user is a member of, as well as actions linked to the user.
- The group feed widget shows actions for the group.