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 CITATION file #242

Merged
merged 3 commits into from
Mar 15, 2022
Merged

Add CITATION file #242

merged 3 commits into from
Mar 15, 2022

Conversation

shaneroesemann
Copy link
Collaborator

PR checklist

  • This comment contains a description of changes (with reason).
  • If you've fixed a bug or added code that should be tested, add tests!
    • If you've added a new tool - have you followed the pipeline conventions in the contribution docs
    • If necessary, also make a PR on the nf-core/autometa branch on the nf-core/test-datasets repository.
  • Make sure your code lints (nf-core lint .).
  • Ensure the test suite passes (nextflow run . -profile test,docker).
  • Usage Documentation in docs/usage.md is updated.
  • Output Documentation in docs/output.md is updated.
  • CHANGELOG.md is updated.
  • README.md is updated (including new tool citations and authors/contributors).

@github-actions
Copy link

github-actions bot commented Feb 23, 2022

nf-core lint overall result: Passed ✅ ⚠️

Posted for pipeline commit eb29f23

+| ✅  62 tests passed       |+
#| ❔  34 tests were ignored |#
!| ❗   9 tests had warnings |!

❗ Test warnings:

  • readme - README did not have a Nextflow minimum version badge.
  • readme - README did not have a Nextflow minimum version mentioned in Quick Start section.
  • schema_lint - Schema $id should be https://raw.githubusercontent.com/autometa/master/nextflow_schema.json
    Found https://raw.githubusercontent.com/autometa/main/nextflow_schema.json
  • schema_description - No description provided in schema for parameter: plaintext_email
  • schema_description - No description provided in schema for parameter: custom_config_version
  • schema_description - No description provided in schema for parameter: custom_config_base
  • schema_description - No description provided in schema for parameter: hostnames
  • schema_description - No description provided in schema for parameter: show_hidden_params
  • schema_description - No description provided in schema for parameter: singularity_pull_docker_container

❔ Tests ignored:

  • files_exist - File is ignored: .github/ISSUE_TEMPLATE/bug_report.yml
  • files_exist - File is ignored: .github/ISSUE_TEMPLATE/feature_request.yml
  • files_exist - File is ignored: .github/workflows/branch.yml
  • files_exist - File is ignored: .github/workflows/ci.yml
  • files_exist - File is ignored: .github/workflows/awstest.yml
  • files_exist - File is ignored: .github/workflows/awsfulltest.yml
  • files_exist - File is ignored: assets/nf-core-autometa_logo_light.png
  • files_exist - File is ignored: docs/usage.md
  • files_exist - File is ignored: docs/output.md
  • files_exist - File is ignored: docs/images/nf-core-autometa_logo.png
  • files_exist - File is ignored: docs/images/nf-core-autometa_logo_light.png
  • files_exist - File is ignored: docs/images/nf-core-autometa_logo_dark.png
  • files_exist - File is ignored: .github/ISSUE_TEMPLATE/bug_report.md
  • files_exist - File is ignored: .github/ISSUE_TEMPLATE/feature_request.md
  • nextflow_config - nextflow_config
  • files_unchanged - File ignored due to lint config: LICENSE or LICENSE.md or LICENCE or LICENCE.md
  • files_unchanged - File ignored due to lint config: .github/CONTRIBUTING.md
  • files_unchanged - File does not exist: .github/ISSUE_TEMPLATE/bug_report.yml
  • files_unchanged - File does not exist: .github/ISSUE_TEMPLATE/feature_request.yml
  • files_unchanged - File ignored due to lint config: .github/PULL_REQUEST_TEMPLATE.md
  • files_unchanged - File does not exist: .github/workflows/branch.yml
  • files_unchanged - File ignored due to lint config: .github/workflows/linting_comment.yml
  • files_unchanged - File ignored due to lint config: .github/workflows/linting.yml
  • files_unchanged - File ignored due to lint config: assets/email_template.html
  • files_unchanged - File ignored due to lint config: assets/email_template.txt
  • files_unchanged - File does not exist: assets/nf-core-autometa_logo_light.png
  • files_unchanged - File does not exist: docs/images/nf-core-autometa_logo_light.png
  • files_unchanged - File does not exist: docs/images/nf-core-autometa_logo_dark.png
  • files_unchanged - File ignored due to lint config: docs/README.md
  • files_unchanged - File ignored due to lint config: lib/NfcoreTemplate.groovy
  • files_unchanged - File ignored due to lint config: .gitignore or foo
  • actions_ci - '.github/workflows/ci.yml' not found
  • actions_awstest - 'awstest.yml' workflow not found: /home/runner/work/Autometa/Autometa/.github/workflows/awstest.yml
  • template_strings - template_strings

✅ Tests passed:

Run details

  • nf-core/tools version 2.2
  • Run at 2022-02-27 15:42:52

@evanroyrees evanroyrees requested review from evanroyrees and chasemc and removed request for evanroyrees February 23, 2022 21:08
@evanroyrees evanroyrees added the documentation Improvements or additions to documentation label Feb 23, 2022
@codecov
Copy link

codecov bot commented Feb 23, 2022

Codecov Report

Merging #242 (eb29f23) into main (ad0364a) will decrease coverage by 0.29%.
The diff coverage is n/a.

Impacted file tree graph

@@            Coverage Diff             @@
##             main     #242      +/-   ##
==========================================
- Coverage   27.61%   27.31%   -0.30%     
==========================================
  Files          45       45              
  Lines        5334     5334              
==========================================
- Hits         1473     1457      -16     
- Misses       3861     3877      +16     
Flag Coverage Δ
unittests 27.31% <ø> (-0.30%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files Coverage Δ
autometa/binning/unclustered_recruitment.py 83.15% <0.00%> (-8.70%) ⬇️

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update ad0364a...eb29f23. Read the comment docs.

CITATION.cff Outdated Show resolved Hide resolved
CITATION.cff Outdated Show resolved Hide resolved
CITATION.cff Outdated Show resolved Hide resolved
CITATION.cff Outdated Show resolved Hide resolved
CITATION.cff Outdated Show resolved Hide resolved
CITATION.cff Outdated Show resolved Hide resolved
Copy link
Member

@chasemc chasemc left a comment

Choose a reason for hiding this comment

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

Couple things:

You made a PR against the main branch, so you'll want to go back and make a PR against the dev branch

.cff is a type of yaml file so it's sensitive to indentation (which made it really difficult to use the suggestions through github's review system)

I'll add some comments to the file you added in a second, but you'll want to make the indentation match how it is below (also changed a field). I don't think what you did was incorrect for the format, but using as below makes sure it is displayed by GitHub correctly (I tested it on a personal repository of mine)

Also, the...

title: Autometa
authors: 
  - family-names: Kwan
    given-names: Jason C.

part can be deleted (otherwise it would be a running tab of contributors and software release info like:
https://github.com/github/docs/blob/277d335aebeb703cdbe979916ad815e7967e129c/content/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-citation-files.md?plain=1#L93-L105

cff-version: 1.2.0
message: 'If you use this software, please cite it as below.'
preferred-citation:  
   type: article
   authors:
   - given-names: Ian J.
     family-names: Miller
   - given-names: Evan R.
     family-names: Rees
   - given-names: Jennifer
     family-names: Ross
   - given-names: Izaak
     family-names: Miller
   - given-names: Jared
     family-names: Baxa
   - given-names: Juan
     family-names: Lopera
   - given-names: Robert L.
     family-names: Kerby
   - given-names: Federico E.
     family-names: Rey
   - given-names: Jason C.
     family-names: Kwan
     orcid: 'https://orcid.org/0000-0001-9933-1536'
   title: 'Autometa: automated extraction of microbial genomes from individual shotgun metagenomes'
   year: 2019
   journal: Nucleic Acids Research
   volume: 47
   issue: 10  
   url: 'https://github.com/KwanLab/Autometa'
   doi: 10.1093/nar/gkz148

@shaneroesemann
Copy link
Collaborator Author

shaneroesemann commented Feb 24, 2022

happy to make the branch change.

title: Autometa
authors: 
  - family-names: Kwan
    given-names: Jason C.

^^ this needed to be included. At least through the context of validating the .cff with cffconvert. I originally did not have it but the validation required a title and author field in the first indentation. Maybe I can look into validating it on my personal github and/or look into a different validation package (i see there is at least one other).

I can make the changes you suggested, thanks

@shaneroesemann
Copy link
Collaborator Author

@chasemc @WiscEvan
OK I made the changes requested. I think I pushed to the dev branch this time. thanks

@chasemc chasemc changed the base branch from main to dev March 14, 2022 20:26
@chasemc
Copy link
Member

chasemc commented Mar 14, 2022

Looks good, I checked it in another repo and it shows the citation as the v1 manuscript
I changed the PR to merge into dev

@chasemc
Copy link
Member

chasemc commented Mar 14, 2022

@WiscEvan I don't get why codecov is picking up on an unchanged file?

@evanroyrees
Copy link
Collaborator

@WiscEvan I don't get why codecov is picking up on an unchanged file?

I'm not sure why codecov is picking this up. It has shown some odd behavior in the past 🤷

@evanroyrees evanroyrees merged commit f19896f into dev Mar 15, 2022
@evanroyrees evanroyrees deleted the issue-241 branch March 15, 2022 16:34
evanroyrees added a commit that referenced this pull request Mar 15, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

You can add a CITATION file to your repository to help users correctly cite your software.
3 participants