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

Review of submission Daun_RE_AE #6

Open
LloydThinks opened this issue Jun 28, 2021 · 13 comments
Open

Review of submission Daun_RE_AE #6

LloydThinks opened this issue Jun 28, 2021 · 13 comments

Comments

@LloydThinks
Copy link
Collaborator

LloydThinks commented Jun 28, 2021

Author: @tenbergen
Reviewer 1: tba
Reviewer 2: @johndoejohndoejohndoee

@johndoejohndoejohndoee
Copy link

johndoejohndoejohndoee commented Jul 6, 2021

Specific comments:

  • Number mismatch for every table: Table II - "Proposal of solution" - 69 in the excel, but 68 in the Paper. Same with "Type of learners". Table IV - many examples. Please carefully check your numbers again.
  • The URL is not immutable. As outlined in the Eligibility and Evaluation Criteria, the URL cannot be an institutional website
  • The README section should contain direct link to the artifact

Artifacts Available - Available Badge

  • Artifacts are hosted online - Yes
  • The URL to access the artifacts is immutable (cannot be altered by the author) - No
  • The organisation hosting the URL plans to maintain it for the foreseeable future. - Not sure
  • Artifacts have a Digital Object Identifier (DOI) redirecting to the immutable URL. - DOI is present
  • Anyone can access the artifacts, without the need for registration. - Yes

Artifacts Reusable - Reusable Badge

  • Artifacts can be obtained via the “Artifact Location” README section. - No
  • Artifacts are documented in the “Descriptions of Artifacts” README section. - Yes
  • Artifacts can be installed and run via the “Installation Instructions” README section. - N/A
  • Artifacts generate the results presented in the article following the “Steps to Reproduce” README section. - See comments
  • Artifacts have a proper open-source license attached as a LICENSE.md file - N/A
  • The artifacts are very carefully documented and well-structured to the extent that reuse and repurposing is facilitated. Norms and standards of the research community for artifacts of this type are strictly adhered to. - See comments

@LloydThinks
Copy link
Collaborator Author

Thank you @johndoejohndoejohndoee for your initial review. Upon internal review, it appears that the SmithScholarWorks "is an institutional repository that provides permanent online access to advance scholarship and encourage the growth of scholarly communities through open access, quick discovery, and wide dissemination of scholarly and creative content" [1]. For this reason, we believe it qualifies as an immutable and long-term solution to storing the artifact.

@tenbergen You have applied for all four badges and I hope to clear up some potential confusion regarding how you can qualify for these badges:

  • Available Badge: As reviewed above and clarified by the track Co-Chairs, we believe your artifact already qualifies for this badge.
  • Reusable: There does not appear to be a README.md or LICENSE.md attached to your data artifact available at the provided by the SmithScholarWorks link. These two files, as outlined in our submission guidelines [2], are very important and must be included. If you wish to qualify for the Reusable badge, please create these two files and put them in the same repository as your current submission (a single link must lead to the complete package).
  • You have also applied for the Reproduced and Replicated badges, however, you can only qualify for one of them, depending on the requirements met. I tried to read your pre-print, but it has been deleted from your GoogleDrive. This is why we recommend using services like arXiv that maintain pre-prints forever. Regardless, if YOU replicated someone else's work, then the OTHER article would receive the Reproduced or Replicated badge, not your article. This is because the OTHER work has now been Reproduced/Replicated. Additionally, only past RE submissions can receive the Reproduced or Replicated badge, so once you have provided a valid link to your pre-print, I would check the replicated article's submission venue to assess quantifiability.

I hope this clears some things up. Let me know if you have any additional questions. We are still waiting to hear from the second reviewer, who can help provide some final clarity on the Reusability of your work, should you choose to create the required documentation as outline in the submission guidelines [2].

[1] https://scholarworks.smith.edu/about.html
[2] https://conf.researchr.org/getImage/RE-2021/orig/RE%2721+Artifact+Track+-+Submission+and+Reviewing+Guidelines.pdf

@johndoejohndoejohndoee
Copy link

johndoejohndoejohndoee commented Jul 8, 2021

SmithScholarWorks "is an institutional repository that provides permanent online access to advance scholarship and encourage the growth of scholarly communities through open access, quick discovery, and wide dissemination of scholarly and creative content"

Makes sense to me. So the qualification for Available Badge is met.

My only concern remains is the numbers mismatch between the dataset and the paper, since it's a requirement to be able to reproduce the results for Artifact Reusable, correct?

@tenbergen
Copy link
Contributor

tenbergen commented Jul 8, 2021 via email

@tenbergen
Copy link
Contributor

tenbergen commented Jul 8, 2021 via email

@LloydThinks
Copy link
Collaborator Author

Thank you for the clarification @tenbergen . The process is indeed complicated and we apologise for the confusion.

For the submission documents, we state in the submission guidelines "Required submission documents for the RE AE Track are listed below." and this includes the SUBMISSION.md file as well as the pre-print. We don't explicitly require that you upload your pre-print to arXiv, but when I tried to access your GoogleDrive file, it was in your trash. So please consider using arXiv in the future as it maintains your pre-print forever, which is desirable for Open Science.

As for the Reusable badge, we state in the submission guidelines "The Reusable badge requires additional documents to be created and stored with your artifact." The artifact being your hosted files in the immutable and long-term storage. These files are required for the reviewers to check your work, but more importantly, they are designed to live with your artifacts forever, and act as a guide for future researchers who want to use your work. For this reason, submitting them to GitHub only fulfils the first requirement.

I hope this clears up the purpose of the artifact track and your understanding of Open Science. Our goal is to educate and hopefully bring clarity to the process. We want to see your artifacts used many years into the future 😃

Lloyd

@LloydThinks
Copy link
Collaborator Author

@tenbergen @johndoejohndoejohndoee We outline in the submission guidelines that "All known deviations from results presented in the article must be explicitly outlined (E.g., when a table or figure is not produced, or the produced results are different from the results presented in the paper)." We understand that sometimes Reusable artifacts produce numbers slightly different than the paper. However, in such cases, we hope that you (the author, in your README.md) explain why the artifacts now produce different numbers or slightly off figures. This helps future researchers using your artifacts to understand how to interpret the different numbers.

In the best case, you will update your artifact when you make local changes to your paper. This way, the artifact stays relevant. Most archival services allow you to update documents, even though they don't let you remove documents.

I hope with the updated information we can assign you the Available and Reusable badges. This is up to @johndoejohndoejohndoee and the second reviewer who will be reviewing your artifact shortly.

Lloyd

@tenbergen
Copy link
Contributor

tenbergen commented Jul 9, 2021 via email

@LloydThinks
Copy link
Collaborator Author

The RE website summarises some of the information [1], but the full submission guidelines are linked at the bottom of the page [2].

[1] https://conf.researchr.org/track/RE-2021/RE-2021-artifacts#Call-for-Artifacts
[2] https://conf.researchr.org/getImage/RE-2021/orig/RE%2721+Artifact+Track+-+Submission+and+Reviewing+Guidelines.pdf

@sc4585545
Copy link

Hi all,
I agree with the previous concerns regarding the artifact, and mainly regarding the readme which does not have information regarding the artifact, and no link is provides. My main concern is lacking papers about educational experiences that foster knowledge management, creativity and innovation in RE, and there are many such as the ones provided below. However, the work is impressive and relevant to the conference.

Levy, M. (2020). "Emotional Requirements for Well-being Applications: The Customer Journey", In: Proceedings of REWBAH, The 1st International Workshop on Requirements Engineering for Well-Being, Aging and Health in conjunction with RE’20 – 31 August 2020, Zurich, Switzerland.
Levy, M. (2018). "Educating for Empathy in Software Engineering Course", The 1st International Workshop on Facilitating Inclusive Requirements Engineering (FIRE), co-located with the 24th Working Conference on Requirements Engineering: Foundation for Software Quality (REFSQ), Utrecht, Netherlands.
Levy, M. (2017). "Promoting the Elicitation of Usability and Accessibility Requirements in Design Thinking: Using a Designed Object as a Boundary Object", The 3rd International Workshop on Usability and Accessibility focused Requirements Engineering (UsARE), co-located with the 25th IEEE International Requirements Engineering Conference (RE), Lisbon, Portugal, Sept 4-8, 2017.
Levy, M. (2017). "Design Thinking in Multidisciplinary Learning Teams: Insights from Multidisciplinary Teaching Events". The 1st international workshop on Teaching for Smart Information Systems - Smart Information Systems for Teaching (T4ST4T'17), co-located with the 29th International Conference on Advanced Information Systems Engineering, Essen, Germany, June 12-16, 2017.
Levy, M. and Hadar, I. (2010) “Teaching MBA Students the Use of Web2.0: The Knowledge Management Perspective”, Journal of Information Systems Education. vol. 21, no. 1, pp.55-67.

@tenbergen
Copy link
Contributor

tenbergen commented Jul 9, 2021 via email

@LloydThinks
Copy link
Collaborator Author

Hi @tenbergen , thank you for your patience as the reviews came in.

The purpose of the Artifact Track is to assess the availability and quality of your provided artifacts, combined with the requested documents. In traditional review processes, artifacts such as code are not assessed. In your case, there is a cross-over of assessment because your artifact is an Excel sheet, which, by the nature of your survey paper, was already assessed during the standard review process. I hope you understand the confusion of the situation for everyone involved.

Please attach the README.md and LICENSE.md to your artifact at SmithScholarWorks. While it appears that SmithScholarWorks has a nice landing page of information for your artifact and perhaps it is obvious to some what the licences attached to SmithScholarWorks are, if someone downloads your artifact and closes the webpage, that information is lost.

The Artifact Track Co-Chairs and I will discuss your submission soon and make a decision regarding the badges based on the feedback of the reviewers.

Thank you for your patience. We will get back to you soon regarding our summary judgement.

Lloyd & Nash

@LloydThinks
Copy link
Collaborator Author

Hi @tenbergen,

Nash and I have discussed your submission and here are our findings:

  • Available Badge: We find that your submission qualifies for the available badge.
  • Reproduced and Replicated Badges: We do not find that your submission qualifies for these badges. The criteria explicitly states "The main results of the article have been obtained in a subsequent study that was peer-reviewed and published by a person or team other than the authors, … using, in part, artifacts provided by the author. (Reproduced) … without the use of author-supplied artifacts. (Replicated)" We do not see evidence of someone else reproducing or replicating your work. As such, we do not find that your submission qualifies for either of these badges.
  • Reusable Badge: We believe that your submission could qualify for the Reusable badge if you upload the README.md and LICENSE.md next to your artifact. Their purpose is to facilitate the reuse of your artifact, so they do not serve their purpose unless they are attached to the artifact. As you have already created the README.md and LICENSE.md files, we believe this step should be easy. Once you have done so, please respond to this Github issue letting us know about your update, and we will assign your artifact the badge of Reusable. Please note that you have until Friday July 16th to do so.

We hope we have cleared up some of the confusion. Your feedback has led to some re-thinking about how to explain things already. We look forward to your response and hopefully assigning the Reusable badge as well.

Lloyd & Nash

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants