#1079 Banner on community sites to promote Community Survey
Closed: Fixed 2 years ago by lilyx. Opened 2 years ago by riecatnor.

The Fedora Council is working on a yearly Fedora contributor survey [1,2]. We want to capture as many responses as possible and one of the ways we want to promote the survey is by adding a banner [3] onto a variety of pages that our contributors frequent. Below is a list of websites that we are thinking about adding this to, give or take, for the duration of the when the survey will be open. The survey will run for the month of June.

- https://discussion.fedoraproject.org/
community blog
- https://communityblog.fedoraproject.org/
mailing list (hyperkitty)
- https://lists.fedorahosted.org/archives/
account system
- https://accounts.fedoraproject.org/
- https://start.fedoraproject.org/
- https://docs.fedoraproject.org/en-US/docs/
fedora wiki
- https://fedoraproject.org/wiki/Fedora_Project_Wiki

We need to identify what it will take to get this uploaded on each site, and plan them to be pushed out on June 1st.

[1] https://pagure.io/Fedora-Council/tickets/issue/327
[2] https://hackmd.io/MqPUtYrnSOesig7hJ9RPQg?view#Fedora-Community-Survey
[3] https://pagure.io/design/issue/754

All of these except start.fp.o are outside of the Websites teams's purview. I can help you with the Community Blog separately from this ticket. I'm not sure what to do about the rest. (I learned the hard way that updating the docs theme is an unpleasantly manual process that you'll need to coordinate with Adam Šamalík)

Metadata Update from @bcotton:
- Issue assigned to bcotton

2 years ago

Metadata Update from @bcotton:
- Assignee reset

2 years ago

This is what we have to start.. additional notes welcome

    * Website wishlist:
        - https://discussion.fedoraproject.org/
        - Matthew Miller is the discussions expert

        Community blog (AK)
        - https://communityblog.fedoraproject.org/
        - add as div under navigation-inner section inner (wp php)

        Mailing list (hyperkitty) (rp)
        - https://lists.fedorahosted.org/archives/
        - add as a div above available lists
        - This should be coordinated with infra

        Account system 
        - https://accounts.fedoraproject.org/
        - This should be coordinated with infra

        Start.fedoraproject.org (t0x)
        - https://start.fedoraproject.org/
        - Uses Jinja just like Easyfix did for regularly updating magazine feeds
        - This is where the site is located https://pagure.io/fedora-websites/blob/master/f/start.fedoraproject.org

        Docs.fedoraproject.org (rp)
        - https://docs.fedoraproject.org/en-US/docs/
        - add div element under nav?
        - This requires Adam Samalik

        Fedora wiki (t0x)
        - https://fedoraproject.org/wiki/Fedora_Project_Wiki
        - Referring to the image with the Markdown syntax should be good enough for this one

I have gotten in touch with @mattdm in order for making changes to the main wiki page (as in the landing page that you would find here https://fedoraproject.org/wiki/Fedora_Project_Wiki) and the discussion f.p.o. site - I have received the answers too and the only thing that I am looking for, right now is a definitive link for the survey where we'd lead people to when they click on the banner.

Also, I am collaborating with @codeblock for putting the same on the start f.p.o.

@riecatnor Could you please provide us with the link to the survey?

I can set up Docs so we have a simple way to add banners and alerts to the top of the site. And then I'm happy to put the banner itself in place, or put instructions here.

And I can do that tomorrow morning!


  1. A pull request has been made at https://pagure.io/fedora-websites/ which you can find here https://pagure.io/fedora-websites/pull-request/1080 to introduce a section in the Start f.p.o. page. @codeblock Please review and merge the same - now that June has officially begun. ;-)

  2. Most recently, the banner at Lists f.p.o. was put up. Updates about it can be found here https://pagure.io/fedora-infrastructure/issue/9972. Thanks, @abompard!

  3. The banner is also put up on the Wiki landing page. https://fedoraproject.org/wiki/Fedora_Project_Wiki. Thanks, @mattdm!


  1. https://pagure.io/fedora-websites/pull-request/1080 was merged 3 days back, so the button for accessing the community survey is now available on Start f.p.o. Thanks, @codeblock!
  2. https://communityblog.fedoraproject.org/help-make-fedora-awesome-by-taking-the-first-annual-contributor-survey/ commblog article is up too. Thanks, @riecatnor!
  3. https://discussion.fedoraproject.org/t/annual-fedora-community-survey/30354 is up at Discussion f.p.o. Thanks, @ramyaparimi for the write-up and thanks, @bcotton for pinning it.


Should we consider adding this to Ask f.p.o. too? There are some contributors that I know of, who contribute a lot to the QnA forum.

How to add/remove the Docs.fp.o banner

See this PR that added the banner. It did two things:

  1. Added the image itself to a specific place
  2. Put HTML code in a specific file

That's all that's needed to add a banner.

So, writing it as instructions that can be reused as documentation elsewhere:

Adding a banner

All changes are done in the docs-fp-o repository.

If your banner is an image, add it to supplemental-ui/img/image-name.png within the repository.

Then add any HTML code to the supplemental-ui/partials/announcement.hbs file.

You can now run the usual ./build.sh && ./preview.sh in the repo to see your change locally.

Removing the banner

All changes are done in the docs-fp-o repository.

Remove all HTML code from the supplemental-ui/partials/announcement.hbs file. Do not delete the file itself, otherwise the build will fail.

If there was an image you no longer need (that would be in the supplemental-ui/img/ directory), you can remove it.

You can now run the usual ./build.sh && ./preview.sh in the repo to see your change locally.

Thank you @asamalik for the detailed instructions :thumbsup:

Metadata Update from @lilyx:
- Issue close_status updated to: Fixed
- Issue status updated to: Closed (was: Open)

2 years ago

Login to comment on this ticket.