Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1683125

Summary: no clear way how to report a problem at docs.fedoraproject.org
Product: [Retired] Fedora Documentation Reporter: Kamil Páral <kparal>
Component: docs-requestsAssignee: Petr Bokoc <pbokoc>
Status: CLOSED NOTABUG QA Contact: Fedora Docs QA <docs-qa>
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: develCC: nobody, sparks, stickster, zach
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2019-02-26 11:06:01 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Kamil Páral 2019-02-26 09:56:08 UTC 
I found a broken link in https://docs.fedoraproject.org/en-US/packaging-guidelines/ . I wanted to report that, but... I have no idea where! The page doesn't contain any indication whatsoever (in a header/footer) where to report such issues. That is a big problem, because we'll never know about docs failures if we don't tell users where to report them.

I then went to https://docs.fedoraproject.org/en-US/docs/ and it's the same story. Again, no contact, no tracker link, nothing.

I found this bugzilla entry and I hope somebody will notice this report, but even here, I couldn't find a component that would be "general issues for docs.fp.o".

Please fix this. Provide a clear link for reporting issues/contact on every page that is displayed at docs.fp.o (in a header/footer). Make sure the homepage has relevant info as well. It is critical for keeping our docs usable. Thank you!
Comment 1 Petr Bokoc 2019-02-26 11:06:01 UTC 
Hmm, you're right. We have an "edit this page" link on every page in the top right corner, but that doesn't suggest you can also report bugs using the same link.

We're trying to stay away from Bugzilla for Fedora docs bugs, so I'll move your report to Pagure and close it. New link is here:

I suspect it wouldn't be too hard to add a second link for issue reporting to each page, leading to the repo's issue tracker.

Petr
Comment 2 Petr Bokoc 2019-02-26 11:06:22 UTC 
Dangit! New link is here: https://pagure.io/fedora-docs/docs-fp-o/issue/110
Comment 3 Kamil Páral 2019-02-26 11:38:17 UTC 
If you're trying to stay away from Bugzilla with Fedora content, you should also update:
https://fedoraproject.org/wiki/Docs_Project

Because I googled out that page, and it led me here into Bugzilla.
Comment 4 Petr Bokoc 2019-02-27 07:45:42 UTC 
Good point, thanks, I'll fix that.