SeleniumHQ / SeleniumHQ/seleniumhq.github.io

[🚀 Feature]: Printable documentation for a single language.

Open
#2,264 2 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

needs-triaging
Dominant language
HTML
Stars
1.4k
Forks
1.6k
Avg merge
18h 3m
Merged PRs (30d)
56

Description

Feature and motivation
Description

I would like to print out Selenium's documentation, because reading from the screen makes my eyes sore.

There is a "printable" version of the documentation page https://www.selenium.dev/documentation/webdriver/_print/, but it is not actually printable:

Broken page breaks:

Image

Messed up languages:

Image

Code not fitting on the screen:

Image

Firefox just prints all the languages one under another, thus making the doc 4 times longer:

Image

Have you considered any alternatives or workarounds?

I tried writing a webscraper to fetch the page code and to format it into latex, but my knowledge of Selenium is not good enough to write it intuitively, and I cannot read the doc because it is impossible to download it.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with Selenium's printable documentation page at https://www.selenium.dev/documentation/webdriver/_print/ and inspect its print rendering in Firefox. Check the page breaks, language presentation, and code layout described in the issue. Done means a single-language printout has usable page breaks, fits code on the page, and does not repeat all languages.

Written by the indexing model from the issue text.

Assessment

Tech stack
html, hugo
Domain
documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.