UG pdf is not text-based and cannot be searched / copied

[yadobler]

Summary

The PDF for UG seems to be just pictures of the UG itself, and there is no text that can be selected or searched. Inconvenient for users who may want to quickly search or copy links. (or test them :cry:)

Steps to reproduce

1. Open UG pdf (in browser)
2. Try to search (Ctrl-F) for any word (e.g. list) - nothing can be found
3. Try to select text - nothing can be selected

Expected

Selectible and searchable text

Observed

Tester Information

System Information:

• OS: NixOS 24.11.20240906.574d1ea (Vicuna) x86_64
• Kernel: 6.6.49
• Shell: zsh 5.9
• Resolution: 3000x2000
• DE: hyprland (Wayland)
• Terminal: foot
• CPU: 12th Gen Intel i7-1255U (12) @ 4.700GHz
• GPU: Intel Alder Lake-UP3 GT2 [Iris Xe Graphics]
• Memory: 5734MiB / 15691MiB

Java version:

• openjdk version "17.0.11" 2024-04-16
• OpenJDK Runtime Environment (build 17.0.11+9-nixos)
• OpenJDK 64-Bit Server VM (build 17.0.11+9-nixos, mixed mode, sharing)

[nus-pe-script]

Team's Response

This is a bug arising from not following instructions properly to create the .pdf file. Marked as a duplicate of another bug which states that links in the UG cannot be clicked.

The 'Original' Bug

[The team marked this bug as a duplicate of the following bug]

Unable to click on here and Java link

hyperlinked java and here part are both images, unable to click on it, users will be unable to download the entire file and as a result, unable to use the app

---

_{[original: nus-cs2103-AY2425S1/pe-interim#1241] [original labels: type.DocumentationBug severity.High]}

Their Response to the 'Original' Bug

[This is the team's response to the above 'original' bug]

Accepted as a valid bug, because instructions for creating the .pdf file were not followed properly in our submission.

Severity is adjusted to Medium as nowadays people usually learn about a product from online User Guide website, only a few people will use the pdf version User Guide. While the website does support all the searching function and navigability along with the correct working links, so it should not be a high severity issue.

Items for the Tester to Verify

:question: Issue duplicate status

Team chose to mark this issue as a duplicate of another issue (as explained in the Team's response above)

• [x] I disagree

Reason for disagreement: I agree it is a duplicate in the sense that these 2 bugs cannot be independently fixed.

However, looking at the response, I believe now that the bug is of severity.high because:

Claiming the UG pdf is not important implies that the UG is not designed with usability in mind.

Moreover, the pain points mentioned by the original bug is how the document has links that are not working. However my bug report also mentions of the additional pain points of not being able to search and copy text.

Individually they are severity.medium bugs, but the addressed pain points make these two bugs together a much more serious bug, affecting the usability of the UG.

As seen here:

While users can still open and scroll the UG, the inability to properly use it defeats the purpose of the UG and dissuades potential users too.

---