Skip to content

[ZEPPELIN-3968] Fix wrong MySQL driver class in JDBC doc screenshot - #5368

Open
kimyenac wants to merge 1 commit into
apache:masterfrom
kimyenac:ZEPPELIN-3968
Open

[ZEPPELIN-3968] Fix wrong MySQL driver class in JDBC doc screenshot#5368
kimyenac wants to merge 1 commit into
apache:masterfrom
kimyenac:ZEPPELIN-3968

Conversation

@kimyenac

@kimyenac kimyenac commented Aug 3, 2026

Copy link
Copy Markdown
Contributor

What is this PR for?

The "Edit Properties" screenshot in the JDBC interpreter documentation shows default.driver as org.mysql.jdbc.Driver, which is not a real class. Following the docs as written gives a ClassNotFoundException.

The correct value is com.mysql.jdbc.Driver, which is already what the property tables further down the same page use, so the screenshot was the only place left disagreeing with the rest of the doc.

The screenshot is patched in place rather than recaptured. It dates from the 0.7 era, and a fresh capture would no longer match the surrounding images in the same walkthrough. To keep the font rendering identical, the c, o and m glyphs were taken from elsewhere in the same line of text (jdbc, org, mysql), and the remainder of the string was shifted right by the advance width difference between "org" (1445/1000 em) and "com" (1889/1000 em), about 11px at this scale.

A pixel by pixel comparison against the original confirms only the default.driver value changed: 3,387 pixels inside x 936-1171, y 255-278. The surrounding table, the orange highlight box and the arrow annotation are untouched.

What type of PR is it?

Documentation

Todos

  • - Fix the driver class name in the screenshot

What is the Jira issue?

https://issues.apache.org/jira/browse/ZEPPELIN-3968

How should this be tested?

Open the "Files changed" tab and use the image diff on docs/assets/themes/zeppelin/img/docs-img/edit_properties.png. The default.driver row should read com.mysql.jdbc.Driver, everything else unchanged.

The image is referenced from docs/interpreter/jdbc.md.

Screenshots (if appropriate)

Before: default.driver = org.mysql.jdbc.Driver
After: default.driver = com.mysql.jdbc.Driver

Questions:

  • Does the license files need to update? No
  • Is there breaking changes for older versions? No
  • Does this needs documentation? No

### What is this PR for?
The "Edit Properties" screenshot in the JDBC interpreter doc shows
`default.driver` as `org.mysql.jdbc.Driver`, which is not a real class.
The correct value is `com.mysql.jdbc.Driver`, which is what the property
tables further down the same page already use.

The screenshot is patched in place so the font rendering stays identical
to the rest of the capture: the `c`, `o` and `m` glyphs are re-used from
the same line of text, and the remainder of the string is shifted right
by the advance-width difference between "org" and "com". No other pixel
of the image changes.

### What type of PR is it?
Documentation

### What is the Jira issue?
https://issues.apache.org/jira/browse/ZEPPELIN-3968

### How should this be tested?
Open `docs/interpreter/jdbc.md` and check the "Edit Properties" image now
reads `com.mysql.jdbc.Driver`.

### Screenshots (if appropriate)

### Questions:
* Does the license files need to update? No
* Is there breaking changes for older versions? No
* Does this needs documentation? No
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant