Closed rando2 closed 4 years ago
I am a big fan of issue templates. The OpenPBTA folks use these extensively. GitHub docs on the feature are good: https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository
For examples (probably too extensive to start with but as we learn how people are contributing we'll figure out how they should be designed) the AlexsLemonade/OpenPBTA-analysis repo has some.
I only saw the top of this before. I like the bottom part. I think that at the beginning noting that it's ok to just post a paper and leave the other elements blank as prompts for folks who come to the issue later
Some of the points below are related to @juliettemarie0405's post in https://github.com/greenelab/covid19-review/issues/13. They're also based on my teaching a few lectures on evidence-based medicine and interpreting the scientific literature to medical and graduate students. :-)
One framework that is often used for assessing the literature is the "MAARIE" framework = Method, Assignment, Assessment, Results, Interpretation, Extrapolation (eg from http://cdn.journalism.cuny.edu/blogs.dir/422/files/2012/04/Different_types_studies_fromtextbook.pdf) I'm actually wondering if we should create a table for these elements? It may help to ensure some uniformity between reviewers. Depending on the number of papers, it may be helpful to have 2 reviewers per paper, even if we can't have a bona fide systematic review.
MAARIE framework: Method
Assignment
Assessment
Results
Interpretation
Extrapolation
Adding my two cents as I see a possible solution to the problem of unclaimed/claimed papers. We could coerce the known pattern of stale versus active issues through the GitHub action stale into labeling issues that have not been labelled "claimed" as "unclaimed" after say 7 days. By default, this would be active on all issues unless we devise some exempt label, which I think opens us up to more complexity than just tracking which issues are actively being worked on by someone and which came in as suggestions then went unclaimed.
I like this framing! @SiminaB, do you want to file a PR on the new paper template for this? It looks like it's going to be most appropriate for clinical trials. Is that correct? Should we start to distinguish issue templates by type of paper?
I think we're likely to have in vitro / animal studies as well since many of these compounds are at the very early stages of evaluation for this indication.
Will do! I don't think it will be for clinical trials only, but perhaps would make most sense for human studies.
@cgreene @SiminaB
This isn't an exact partner to the terrific MAARIE tool, but an evaluative risk of bias tool specific for animal studies was developed by a Dutch group called SYRCLE (SYstematic Review Center for Laboratory animal Experimentation) based on the Cochrane tool- maybe helpful?
It asks the following questions:
Reporting Bias
Selection Bias
Performance Bias
Detection Bias
Attrition Bias
Other
@cgreene I noticed you forked an issue renamer action that uses regexes to help organization, is there any plan to use a stale action to help ensure no paper/issue goes too long without being addressed?
I don't have the bandwidth to do that right now but I could see it being helpful.
Thank you for your honesty. If I get the chance, I might draft something up in the coming days.
There have been a whole bunch of efforts to improve this process. Where we are now is definitely than when this issue was filed. I'm going to close this so that it doesn't get scope creep. Please file new issues for new challenges as they arise! @rhagenson : thanks for considering it! 😁
Context As we begin the review, we need a place for contributors to track which papers have been read as well as a place to record summaries of the articles. This will help us to:
Problem We need to make some sort of template to encourage the submission of papers as issues in a standardized format that will allow for filtering, searching, maintenance, etc. It would also be good to recommend contributors include certain pieces of information in their summaries.
Ideas
Request thoughts from @cgreene
Please paste a link to the paper (preferably DOI) or citation information here:
Is this paper primarily relevant to Background, Diagnostics, or Therapeutics? (OK if more than one)
Please list some keywords (3-10) that help identify the relevance of this paper to COVID-19
Please leave a comment with your summary below. Suggested questions to address in summary: