Skip to content

Conversation

mhucka
Copy link
Contributor

@mhucka mhucka commented Sep 25, 2025

This replaces the reStructuredText version of the README file with a Markdown version, for better compatibility with our practices in our other repos. In addition, it removes the OpenFermion logo to follow the updated branding guidelines for Quantum AI. It also slightly reorganizes the content, as well as provides a BibTeX version of the citation info, and finally, adds the standard Google disclaimer and our QAI logo at the bottom.

This replaces the reStructuredText version of the README file with a
Markdown version, for better compatibility with our practices in our
other repos. In addition, it removes the OpenFermion logo to follow the
updated branding guidelines for Quantum AI. It also slightly reorganizes
the content, provides a BibTeX version of the citation info, and adds
the standard Google disclaimer and our QAI logo at the bottom.
This adds the same QAI logo image used in our other repos.
@mhucka mhucka marked this pull request as ready for review September 25, 2025 23:42
@mhucka mhucka changed the title Replace README.rst with Markdown version & update content Fix #1137: replace README.rst with Markdown version & update content Sep 25, 2025
@mhucka mhucka changed the title Fix #1137: replace README.rst with Markdown version & update content Fix #1137 and #908: replace README.rst with Markdown version & update content Sep 25, 2025
@mhucka mhucka added the area/docs Involves documentation, notebooks, README files, and similar label Sep 25, 2025
@mhucka mhucka requested a review from pavoljuhas September 26, 2025 20:35
the electronic structure plugins are only compatible on these platforms. However, for those who
would like to use Windows, or for anyone having other difficulties with installing OpenFermion or
its plugins, we provide instructions for creating and using a Docker image – see the
[`docker/`](https://github.com/quantumlib/OpenFermion/tree/master/docker) subdirectory. The Docker
Copy link
Contributor

Choose a reason for hiding this comment

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

Please replace master --> main here and in other links below.

[![OpenFermion project on PyPI](https://img.shields.io/pypi/v/OpenFermion.svg?logo=semantic-release&logoColor=white&label=Release&style=flat-square&color=fcbc2c)](https://pypi.org/project/OpenFermion)
[![OpenFermion downloads per month from PyPI](https://img.shields.io/pypi/dm/openfermion?logo=PyPI&color=d56420&logoColor=white&style=flat-square&label=Downloads)](https://img.shields.io/pypi/dm/OpenFermion)

[Features](#features) –
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit - would the unicode ndash character work here as well?


## Citing OpenFermion<a name="how-to-cite-openfermion"></a><a name="how-to-cite"></a>

When using OpenFermion for research projects, please cite:
Copy link
Contributor

Choose a reason for hiding this comment

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

I think the previous version was more useful, because it had a link to the actual article. The article page has a button to export citation in BibTeX or RIS format.

Can you replace the bibtex below with human readable citation (as was before) that has a link to the Journal article? Feel free to shorten the authors list to Jarrod R. McClean et al.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/docs Involves documentation, notebooks, README files, and similar
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants