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

[JOSS] misc small items #9

Merged
merged 7 commits into from
Aug 4, 2023
Merged

[JOSS] misc small items #9

merged 7 commits into from
Aug 4, 2023

Conversation

sappelhoff
Copy link
Contributor

@sappelhoff sappelhoff commented Aug 3, 2023

some misc typo corrections and some questions:

  • what is this file about? It looks like a local config file that could/should be removed:

    mTRFpy/mtrf.conf

    Lines 1 to 2 in 0df8aa6

    [mTRFpy]
    TestData: D:/Appendix/Dataset/mTRF/TestData/
  • The license file only contains one of the authors of this software, is this by choice?
    Copyright (c) 2020, Jin Dou
  • is this call to sys needed? What is it for?
    sys.path.append("..\\")
  • could you please add a link to the documentation in the "about" section of the repository:
    image
  • You can also "switch off" the packages and releases information there, which you do not seem to use:
    image
  • I would like to see a PyPI badge in the README: PyPI version
  • I think you would benefit from a .mailmap file, because running git shortlog --email --summary on your repo results in many different identities. For an example, see: https://github.com/mne-tools/mne-bids/blob/main/.mailmap
  • The README file follows an RST syntax, but is a markdown file, I suggest fixing that (e.g., using codeblocks with backticks, and headings with hashtags)
  • remove the JOSS paper build workflow? It's not really needed anymore: https://github.com/powerfulbean/mTRFpy/blob/master/.github/workflows/draft-pdf.yml

@sappelhoff
Copy link
Contributor Author

Not sure if you already have it and I can't see it, but it would be nice to switch on the Readthedocs PR preview feature for this repo: https://docs.readthedocs.io/en/stable/pull-requests.html

@@ -29,6 +29,7 @@
"sphinx.ext.duration",
"sphinx.ext.doctest",
"sphinx.ext.autodoc",
"sphinx.ext.viewcode",
Copy link
Contributor Author

Choose a reason for hiding this comment

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

generates nice "view source" links in the API docs:
image

# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
html_static_path = ["_static"]

Copy link
Contributor Author

Choose a reason for hiding this comment

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

this doesn't exist. better to remove it (it was raising a warning)

path = Path.home() / "mtrf_data"
if not path.exists():
path.mkdir()
else:
path = Path(path)
if not (path / "speech_data.npy").exists(): # download the data
url = "https://github.com/powerfulbean/mTRFpy/raw/master/tests/data/speech_data.npy"
import requests
Copy link
Contributor Author

@sappelhoff sappelhoff Aug 3, 2023

Choose a reason for hiding this comment

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

moving this from a top level import to a nested import here ... because you'd have to declare requests as a dependency otherwise, when actually you just need it to download sample data.

@sappelhoff sappelhoff mentioned this pull request Aug 3, 2023
3 tasks
@OleBialas OleBialas merged commit e735b4f into powerfulbean:master Aug 4, 2023
0 of 4 checks passed
@sappelhoff sappelhoff deleted the typos branch August 5, 2023 18:46
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.

None yet

2 participants