#598 Regular review of QuickDocs articles based on popularity
Closed: stale 4 months ago by hankuoffroad. Opened a year ago by hankuoffroad.

From Google search analytics for the Docs home page, we could see trends on which articles are most popular. In the Docs home page, most read articles are QuickDocs. In this sense, I would like to suggest regular review based on popularity of QuickDocs how-to guides.

  • Raise awareness: start with sharing list of popular QuickDocs how-to guides on a monthly basis on Discussion
  • Get volunteers for technical review
  • Introduce 'maintainer' concept: if a writer/reviewer is an expert on KVM, they will take ownership of PR/Issue review as a priority.
  • Share the result and progress

I'll take a few Quick Docs articles that I'm interested in and had a major review or rewrite.
- Package management
- Change desktop environment
- Raspberry Pi

Please find the thread in Discussion.

https://discussion.fedoraproject.org/t/docs-site-metrics-google-analytics/81738

Another source of data is Ask Common issues tag. Top three categories in Ask are;
- Installation
- Multimedia support
- Bootloader

We could use QA test result in every release and update the guide.


Metadata Update from @hankuoffroad:
- Issue assigned to hankuoffroad

a year ago

Issue tagged with: help wanted

a year ago

+1

Two things I can think of (which i think we've discussed on discussion.fp.o):

  • send "help wanted" e-mails to the devel lists to make experts aware that there is documentation that can use their help (I'm not sure if folks would serve as maintainers, but it's worth a try)
  • send out regular analytics on docs as a way to raise awareness in the community about how important they are?

Edit: not posting on discussions too, since this seems to be the primary ticket for this already

Great ideas, thanks.

  • Sending emails to experts on devel lists sounds like a plan.
    One-off help is much appreciated in the beginning. Maintainer concept could be a longshot, but worth trying for certain experts.

  • Correct on analytics to raise awareness: I'm thinking of monthly Docs analytics and work in progress in this ticket.

Metadata Update from @hankuoffroad:
- Issue set to the milestone: QuickDocs site metrics

a year ago

Metadata Update from @hankuoffroad:
- Assignee reset

8 months ago

I have to drop this, sorry as in the thread below. But I would leave this open for now if someone else can vote up and assist.

https://discussion.fedoraproject.org/t/86435/3

I could use the search stats to prioritize technical review for the writing workshop.

Top 10 pages viewed on the Docs Home page: Apr-Sep 2023
- EPEL
- dnf upgrade
- firewalld
- creating-and-using-a-live-installation-image
- installing-chromium-or-google-chrome-browsers
- Working_with_the_GRUB_2_Boot_Loader
- rpm fusion
- adding-or-removing-software-repositories-in-fedora
- installing java
- switching-desktop-environments

Metadata Update from @hankuoffroad:
- Issue assigned to hankuoffroad

6 months ago

Metadata Update from @hankuoffroad:
- Issue priority set to: next meeting (was: awaiting triage)

6 months ago

Top 10 pages viewed on the Docs Home page: Jan-Dec 2023. Closing this due to inactivity.

EPEL
dnf system upgrade
firewalld
creating-and-using-a-live-installation-image
https://docs.fedoraproject.org/en-US/releases/f39/
Working_with_the_GRUB_2_Boot_Loader
https://docs.fedoraproject.org/en-US/releases/f38/
Installing Java
adding-or-removing-software-repositories-in-fedora
upgrading-fedora-offline

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

4 months ago

Login to comment on this ticket.

Metadata
Boards 1
QuickDocs Boards Status: Triaged