Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add logo, update documentation #110

Merged
merged 3 commits into from
Nov 3, 2023
Merged

Add logo, update documentation #110

merged 3 commits into from
Nov 3, 2023

Conversation

gamatos
Copy link
Collaborator

@gamatos gamatos commented Nov 2, 2023

  • Add formatted list of gates to documentation (closes Nicer gate documentation #100 )
  • Summarise README.md, move some content to documentation
    • Move examples to documentation
    • Move "Getting started" to documentation, summarise and replace by "Quick start"
  • Add logo to README.md
  • Add logo to documentation
  • Add some custom CSS styles to documentation
  • Enable MyST parser in documentation conf.py
  • Add MyST parser to documentation requirements

Documentation seems to be rendering fine (tested directly by running the GitHub build action). @cqc-melf would it be possible to trigger a build and deploy without releasing a new version? Some links in the README.md now refer to new sections in the documentation.

The MyST parser is currently being used to parse markdown files into the documentation, and will be useful in a future PR where we embed the Jupyter notebooks directly in the documentation.

Hope everyone likes the logo!

- Add formatted list of gates to documentation
- Summarise README.md, move some content to documentation
    * Move examples to documentation
    * Move "Getting started" to documentation, summarise and replace by "Quick start"
- Add logo to README.md
- Add logo to documentation
- Add custom CSS styles to documentation
- Enable MyST parser in documentation `conf.py`
- Add MyST parser to documentation requirements
Copy link
Collaborator

@gabrielcqc gabrielcqc left a comment

Choose a reason for hiding this comment

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

Nice logo! :)

Copy link
Collaborator

@cqc-melf cqc-melf left a comment

Choose a reason for hiding this comment

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

Have you taken a look on the html files generated on the CI if they all look as you are expecting?

@@ -1,2 +1,3 @@
sphinx ~= 7.2
sphinx_rtd_theme
myst_parser
Copy link
Collaborator

Choose a reason for hiding this comment

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

Do you want to add a version to this?

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Done ✅

@gamatos
Copy link
Collaborator Author

gamatos commented Nov 2, 2023

Have you taken a look on the html files generated on the CI if they all look as you are expecting?

Yup, the files in the artifact generated by the CI action seem to be all good!

Would it be possible to trigger a build and deploy without releasing a new version? Some links in the README.md now refer to new sections in the documentation.

@cqc-melf
Copy link
Collaborator

cqc-melf commented Nov 2, 2023

Have you taken a look on the html files generated on the CI if they all look as you are expecting?

Yup, the files in the artifact generated by the CI action seem to be all good!

Would it be possible to trigger a build and deploy without releasing a new version? Some links in the README.md now refer to new sections in the documentation.

Yes that is possible, we just need to merge the changes into the main branch...

@gamatos
Copy link
Collaborator Author

gamatos commented Nov 3, 2023

Added one last tweak to the logo since the previous version's colours were a bit too faded, the new one is here.

@gamatos gamatos merged commit 04101d5 into develop Nov 3, 2023
5 checks passed
@gamatos gamatos deleted the add_logo_update_docs branch November 3, 2023 11:26
gamatos added a commit to gamatos/qujax that referenced this pull request Nov 8, 2023
- Add formatted list of gates to documentation
- Summarise README.md, move some content to documentation
    * Move examples to documentation
    * Move "Getting started" to documentation, summarise and replace by "Quick start"
- Add logo to README.md
- Add logo to documentation
- Add custom CSS styles to documentation
- Enable MyST parser in documentation `conf.py`
- Add MyST parser to documentation requirements
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.

Nicer gate documentation
3 participants