openSUSE / mentoring

The openSUSE Developer Mentoring Program
http://101.opensuse.org
60 stars 49 forks source link

Stable version page - Link to PDF document #224

Closed adritek closed 5 months ago

adritek commented 6 months ago

Project Title: Uyuni Website Refresh - Accessibility and Responsiveness (#205)

Accessibility Issue

Page
Stable version page Severity: Warning

Description
Links to a PDF document are present. Unless authored with accessibility in mind, PDF documents often have accessibility issues. Additionally, PDF documents are typically viewed using a separate application or plug-in, and can thus cause confusion and navigation difficulties.

Because PDF documents may have limitations in accessibility (particularly for complex content) and require a separate program, HTML content should often be used in place of or in addition to the PDF document.

Proposed Solution
Solution: Ensure the PDF document is natively accessible. Additionally, inform the user that the link will open a PDF document by adding a more informative descriptive link text. This can help users understand what to expect when clicking the link. An example of link text being: "Quick Start Guide (PDF)".

Screenshot Screen Shot 2024-05-22 at 2 24 47 am

deneb-alpha commented 5 months ago

moved to https://github.com/uyuni-project/uyuni-project.github.io/issues/120