Skip to content

Conversation

mhucka
Copy link
Contributor

@mhucka mhucka commented Mar 25, 2025

Changes:

  • Remove empty H1 heading that I must have accidentally left in

  • Update Cirq logo SVG to switch to using white letters when the user has dark mode enabled

  • Add the QAI logo to the bottom of the page.

  • Add an aditional anchor named #how-to-cite, for better backward compatibility with some documentation that might have used (or still uses) a link with that anchor

  • Fix a random niggle or two

I guess I accidentally left an empty `#` at the top of the file. This
leads to a minor glitch in the markdown rendering on GitHub.
@mhucka mhucka marked this pull request as ready for review March 25, 2025 21:26
@mhucka mhucka requested review from a team and vtomole as code owners March 25, 2025 21:26
Copy link

codecov bot commented Mar 25, 2025

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.66%. Comparing base (5112418) to head (68a7f00).
Report is 2 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #7186      +/-   ##
==========================================
- Coverage   98.66%   98.66%   -0.01%     
==========================================
  Files        1106     1106              
  Lines       96086    96086              
==========================================
- Hits        94808    94806       -2     
- Misses       1278     1280       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Copy link
Collaborator

@pavoljuhas pavoljuhas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The logo image needs to have an absolute URL for PyPI.

If it takes too much work to verify if light / dark logos work on PyPI it is probably not worth the trouble and an extra likelihood of breaking things by us or by GitHub in the future.

https://www.geeksforgeeks.org/kiss-principle-in-software-development/

LGTM for the text tweaks.

PS: consider removing the #readme anchors, it is unclear if they improve usability for visitors.

mhucka added 7 commits March 25, 2025 16:55
I noticed that several of the other projects have (or had) sections
titled How to Cite, and then in some documentation files, the links to
citation info uses `#how-to-cite` anchors. Just to be safe in case not
all links have been updated everywhere, let's add an additional
hyperlink anchor `#how-to-cite` here too.
Don't need to use `<name@address>` when `name@address` will do.
This uses a GitHub feature for detecting if the user has turned on
dark mode, and switches the Cirq logo appropriately.
@mhucka mhucka force-pushed the mh-fix-readme-glitches branch from 42f0b4f to 034e276 Compare March 25, 2025 23:55
@mhucka
Copy link
Contributor Author

mhucka commented Mar 26, 2025

I forced-pushed an update that removed the use of #readme in links, after internal discussion concluded that it's not desirable after all.

@mhucka mhucka self-assigned this Mar 26, 2025
@mhucka mhucka added area/docs priority/after-1.5 Leave for after the Cirq 1.5 release labels Mar 26, 2025
@mhucka mhucka marked this pull request as draft March 26, 2025 18:46
mhucka added 3 commits April 15, 2025 09:17
Turns out to be unnecessary after all.
Also changed the <title> tag value to something more sensible.
The new text is per latest Google guidance for open-source projects.
@mhucka mhucka requested a review from pavoljuhas April 15, 2025 16:48
@mhucka mhucka marked this pull request as ready for review April 15, 2025 16:48
@github-actions github-actions bot added the size: S 10< lines changed <50 label Apr 15, 2025
@mhucka mhucka changed the title Fix some README glitches and improve logo Fix minor README glitches, update Cirq logo to respond to dark/light mode, and add QAI logo Apr 16, 2025
Copy link
Collaborator

@pavoljuhas pavoljuhas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, thanks for doing this!

@mhucka mhucka added this pull request to the merge queue Apr 24, 2025
Merged via the queue into quantumlib:main with commit 1a7688a Apr 24, 2025
39 checks passed
@mhucka mhucka deleted the mh-fix-readme-glitches branch April 24, 2025 23:11
BichengYing pushed a commit to BichengYing/Cirq that referenced this pull request Jun 20, 2025
…mode, and add QAI logo (quantumlib#7186)

* Remove blank H1 heading

I guess I accidentally left an empty `#` at the top of the file. This
leads to a minor glitch in the markdown rendering on GitHub.

* Add additional #how-to-cite anchor

I noticed that several of the other projects have (or had) sections
titled How to Cite, and then in some documentation files, the links to
citation info uses `#how-to-cite` anchors. Just to be safe in case not
all links have been updated everywhere, let's add an additional
hyperlink anchor `#how-to-cite` here too.

* Use a bare link for the contact email address

Don't need to use `<name@address>` when `name@address` will do.

* Add versions of the Cirq logo for black and white backgrounds

* Switch logos depending on dark or light mode

This uses a GitHub feature for detecting if the user has turned on
dark mode, and switches the Cirq logo appropriately.

* Remove duplicate logo file & rename remaining one

Per review comments.

* Put back absolute image URLs

* Use <picture> for logo

* Remove Cirq_logo_color_white_text.svg

Turns out to be unnecessary after all.

* Make logo responsive to light/dark mode

Also changed the <title> tag value to something more sensible.

* Update disclaimer in README

The new text is per latest Google guidance for open-source projects.

* Add QAI logo to bottom of README file

* Add a copy of the QAI logo in SVG format

This one has been adapted to use light/dark mode handling.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs priority/after-1.5 Leave for after the Cirq 1.5 release size: S 10< lines changed <50

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants