fedora-docs / quick-docs

Clone
Source Code
GIT

#598 Regular review of QuickDocs articles based on popularity
Opened 4 months ago by hankuoffroad. Modified 2 months ago

Open
Close issue as:
complete duplicate insufficient data moved not possible out of scope stale

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
4 months ago

Issue tagged with: help wanted
4 months 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
Edited 4 months ago by ankursinha

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.
Edited 4 months ago by hankuoffroad

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

Metadata Update from @hankuoffroad:
- Assignee reset
2 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

Login to comment on this ticket.

Metadata
None

help wanted

None
None
awaiting triage
Boards 1
QuickDocs Boards Status: Triaged
Powered by Pagure 5.13.3
Documentation • File an Issue • About • SSH Hostkey/Fingerprint
© Red Hat, Inc. and others.