Open reikookamoto opened 4 years ago
The package includes all the following forms of documentation:
setup.py
file or elsewhere.Readme requirements The package meets the readme requirements below:
The README should include, from top to bottom:
Note: Be sure to check this carefully, as JOSS's submission requirements and scope differ from pyOpenSci's in terms of what types of packages are accepted.
The package contains a paper.md
matching JOSS's requirements with:
Estimated hours spent reviewing: 1
This is a really neat package that I definitely would use for formatting visualizations for presentations about my UBC teaching! What a great idea!
would be nice to have a link to the Read the Docs docs that is obvious and in english (as opposed to just the docs button, which might not be as obvious to new Python users, see the Pandas repo for example: https://github.com/pandas-dev/pandas#documentation)
please add how your package should be cited (formatting it as a bibTex citation would be great too!)
Would be neat to demo in your package how someone can add a new theme... For example, the broom package in R has a vignette called "adding-tidiers" which guides folks on adding an new broom method for different model objects.
It would be really neat to have a function that takes in a list of hex colours a font and creates a template function for the user... I think this could be done using templating?
even neater, would be for you to have a function that writes their new function to file so that they could easily submit a PR to add a new theme!
The package includes all the following forms of documentation:
setup.py
file or elsewhere.Readme requirements The package meets the readme requirements below:
The README should include, from top to bottom:
Note: Be sure to check this carefully, as JOSS's submission requirements and scope differ from pyOpenSci's in terms of what types of packages are accepted.
The package contains a paper.md
matching JOSS's requirements with:
Estimated hours spent reviewing: 2
This package is very cool and super useful. It was a joy to review it. All documentation, vignette and installation instructions were clear and easy to follow. Everything worked as expected and I was able run all examples in the README with no issues. I even ran the colour themes on different datasets and plots than what was provided in the README and everything worked as expected. Fantastic job!
Additional Thoughts/suggestions:
Documentation
section of the reviewer template it asks for Metadata. I wasn't able to check this off because I wasn't able to find this information if it exists. hueniversitypy in the Python ecosystem
. (the word alongside
is misspelled)Thank you @aromatic-toast, for providing insightful feedback to our package. We tried to incorporate all the feedback given by you, and following is our update on that:
Documentation
section of the reviewer template it asks for Metadata. I wasn't able to check this off because I wasn't able to find this information if it exists.
hueniversitypy in the Python ecosystem
. (the word alongside
is misspelled)
Once we have addressed feedback from all the reviewers, we will create a new release for the package and update you on that.
Regards, Shivam Verma
Hi @ttimbers
Thanks for the suggestions for the package! We have addressed the first two points. We moved the Read the Docs link further up in the README.md above the usage so it is obvious, and we added how the package should be cited including bibtex.
For your final three points, we agree they are all great suggestions! The ability to build a theme would allow this package to be useful globally for all universities and colleges, especially if we were to create a function to allow a user to do it. For now it is out of our scope, but is something to consider for future improvements.
Thanks! -hueniversitypy team
Hi all, Please see the attached link for version 1.1.1 where the changes mentioned above have been implemented.
Nice work folks! Very cool to see these improvements to your package!
name: Submit Software for Review about: Use to submit your Python package for peer review title: '' labels: 1/editor-checks, New Submission! assignees: ''
Submitting Author: Reiko Okamoto (@reikookamoto), Evelyn Moorhouse (@evelynmoorhouse), Simardeep Kaur (@SimardeepKaur), Shivam Verma (@vermashivam679) (Group 16) Package Name: hueniversitypy One-Line Description of Package: Python package for creating visualizations in line with visual identities of Canadian universities Repository Link: hueniversitypy Version submitted: v1.1.0 Editor: @kvarada Reviewer 1: @aromatic-toast Archive: TBD
Version accepted: TBD
Description
This Python package allows users to apply university-specific themes to Altair plots. This package currently supports the official colour palettes of four institutions belonging to the U15 Group of Canadian Research Universities: University of Alberta, the University of British Columbia, McGill University, and the University of Toronto. In the future, we hope to extend this package to support the visual identities of all universities in the association.
Scope
* Please fill out a pre-submission inquiry before submitting a data visualization package. For more info, see this section of our guidebook.
@tag
the editor you contacted:Technical checks
For details about the pyOpenSci packaging requirements, see our packaging guide. Confirm each of the following by checking the box. This package:
Publication options
JOSS Checks
- [ ] The package has an **obvious research application** according to JOSS's definition in their [submission requirements](https://joss.readthedocs.io/en/latest/submitting.html#submission-requirements). Be aware that completing the pyOpenSci review process **does not** guarantee acceptance to JOSS. Be sure to read their submission requirements (linked above) if you are interested in submitting to JOSS. - [ ] The package is not a "minor utility" as defined by JOSS's [submission requirements](https://joss.readthedocs.io/en/latest/submitting.html#submission-requirements): "Minor ‘utility’ packages, including ‘thin’ API clients, are not acceptable." pyOpenSci welcomes these packages under "Data Retrieval", but JOSS has slightly different criteria. - [ ] The package contains a `paper.md` matching [JOSS's requirements](https://joss.readthedocs.io/en/latest/submitting.html#what-should-my-paper-contain) with a high-level description in the package root or in `inst/`. - [ ] The package is deposited in a long-term repository with the DOI: *Note: Do not submit your package separately to JOSS*Are you OK with Reviewers Submitting Issues and/or pull requests to your Repo Directly?
This option will allow reviewers to open smaller issues that can then be linked to PR's rather than submitting a more dense text based review. It will also allow you to demonstrate addressing the issue via PR links.
Code of conduct
P.S. Have feedback/comments about our review process? Leave a comment here
Editor and Review Templates
Editor and review templates can be found here