= Nuancier SOP Nuancier is the web application used by the design team and the community to submit and vote on the supplemental wallpapers provided with each version of Fedora. == Contents * <<_contact_information>> * <<_review_an_election>> * <<_vote_on_an_election>> * <<_view_all_the_candidates_of_an_election>> * <<_view_the_results_of_an_election>> * <<_miscellaneous>> == Contact Information Owner:: Fedora Infrastructure Team Contact:: #fedora-admin Location:: https://apps.fedoraproject.org/nuancier Servers:: nuancier01, nuancier02, nuancier01.stg, nuancier02.stg Purpose:: Provide a system to submit and vote on supplemental wallpapers == Create a new election * Login * Go to the _Admin_ panel via the menu at the top * Click on _Create a new election_ * Complete the form: + Election name:: A short name used in all the pages, most often since we have one election per release it has been of the form _Fedora XX_ Name of the folder containing the pictures:: This just links the election with the folder where the images will be uploaded on disk. Keep it simple, safe, something like _fXX_ will do. Year:: The year when the election will be happening, this will just give some quick sorting option Submission start date (in UTC):: The date from which the people will be able to submit wallpapers for the election. The submission starts on the exact day at midnight UTC. Start date (in UTC):: The date when the election starts (and thus the submissions end). There is no buffer between when the submissions end and when the votes start which means admins have to keep up with the submissions as they are done. End date (in UTC):: The date when the election ends. There are no embargo on the results, they are available right after the election ends. URL to claim a badge for voting:: The URL at which someone can claim a badge. This URL is displayed on the voting page as well as ones people have voted. Which means that having the badge does not ensure people voted, at max it ensures people visited nuancier during a voting phase. Number of votes an user can make:: The number of wallpapers an user can choose/vote on. This was made as they was a debate in the design team if having everyone vote on all 16 wallpapers was a good idea or not. Number of candidate an user can upload:: Restricts the number of wallpapers an user can submit for an election to prevent people from uploading tens of wallpapers in one election. == Review an election Admins must do that regularly during a submission phase to avoid candidates from piling up. * Login * Go to the _Admin_ panel via the menu at the top * Find the election of interest in the list and click on _Review_ If the images are not showing, you can generate the thumbnails using the button _(Re-)generate cache_. On the review page, you will be able to filter the candidates by _Approved_, _Pending_, _Rejected_ or see them _All_ (default). You can then check the images one by one, select their checkbox and then either _Approve_ or _Deny_ all the ones you selected. [NOTE] ==== Rejections must be motivated in the _Reason for rejection / Comments_ input field. This motivation is then sent by email to the user explaining why a wallpaper they submitted was not accepted into the election. ==== == Vote on an election Once an election is opened, a link announcing it will be available from the front page and in the page listing the elections (_Elections_ tab in the menu) a green check-mark will appear on the _Votes_ column while a red forbidden sign will appear on the _Submissions_ column. You can then click on the election name which will take you on the voting page. There, enlarge the image by clicking on them and make your choice by clicking on the bottom right corner of the image. On the column on the right the total number of vote available will appear. If you need to change remove a wallpaper from your selection, simply click on it in the right column. As long as you have not picked the maximum number of candidates allowed, you can cast your vote multiple times (but not on the same candidates of course). == View all the candidates of an election All the candidates of an election are only accessible once the election is over. If you wish to see all the images uploaded, simply go to the _Elections_ tab and click on the election name. == View the results of an election The results of an election are accessible immediately after the end of it. To see them, simply click the _Results_ tab in the menu. There you can click on the name of the election to see the wallpaper ordered by their number of votes or on _stats_ to view some stats about the election (such as the number of participants, the number of voters, votes or the evolution of the votes over time). == Miscellaneous Nuancier uses a gluster volume shared between the two hosts (in prod and in stg) where are stored the images, making sure they are available to both frontends. This may make things a little trickier sometime, be aware of it.