AEA: Instructions for Papers and Proceedings checks#

You will be assigned a Jira issue. It should look something like this:

Take note of the 4 highlighted fields:

  • (1) the “AEAREP” number (identifier for the issue on Jira)

  • (2) the “Manuscript Central Number” (identifier on the AEA’s editorial system)

  • (3) the “openICPSR Project Number” (identifier on the ICPSR system)

  • (4) the link for “Replication package URL”, which should direct you directly to openICPSR

Additionally, certain steps below (i.e. transitioning to “Pending Publication”) require that you have “Publisher” permission in Jira. If it is unclear whether or not you have that permission, please reach out to a supervisor.

Note

Here’s the guidance document.

Step 1#

You should now do the following:

  • Open the link in (4) on openICPSR, (more rarely) Zenodo, or Dataverse

    • If you need to find the openICPSR repository, use this link

  • Open the form: link here

  • Assess the openICPSR repository, filling out the form as you go along

Requirements

open ICPSR

Dataverse

Zenodo

open ICPSR number

Applicable

N/A: Use doi number to distinguish

N/A: Use doi number to distinguish

Manuscript Number

Applicable

Applicable

Applicable

Jira Ticket (Internal Reference)

Applicable

Applicable

Applicable

Title

Applicable

Applicable

Applicable

Principal Investigators

Applicable

Applicable: Go to metadata, look for author

Applicable: Name is right below title

Summary/Description

Applicable

Applicable: Go to metadata, look for description

Applicable: Look at description below Author

JEL Classification

Applicable

N/A

N/A

Manuscript ID

Applicable

Applicable

Applicable

No ZIP Files

Applicable

Applicable

Applicable

README Format

Applicable

Applicable

Applicable

Subject Terms

Applicable

N/A

N/A

Geographic Coverage

Applicable

N/A

N/A

Time Period(s)

Applicable

N/A

N/A

Funding Sources

Applicable

N/A

N/A

Collection Dates

Applicable

N/A

N/A

Data Types

Applicable

N/A

N/A

Data Sources

Applicable

N/A

N/A

Unit of Observation

Applicable

N/A

N/A

  • It is important that you enter the AEAREP and Manuscript numbers accurately. We suggest copying-and-pasting.

  • Submit the form.

  • Close the form after each issue, and open it again for the next one.

  • Navigate to the “PandP Docs” Google Drive folder here, locate the PDF with the Jira ticket of the case you are working on (PDF format: Report-PandP-AEAREP-xxxx.pdf), and download the file. This is the PDF version of the checklist form using the information you entered.

In Jira:

  • Move the issue forward by choosing “Process PandP” to status “Submitted PandP Form

    • This indicates that you have completed the form.

  • Attach the downloaded PDF to the Jira ticket.

Step 2#

Once the form PDF has been added to the issue, you should first return to the openICPSR repository, and then come back to Jira. Depending on what’s on the form, proceed to do one of the following:

If the form has all “required” elements checked, you should “sign off”#

  • Write a “Project communication log” entry. After clicking on “+ add entry”, copy the following to the relevant cell. Update AEAREP number accordingly.

    • Subject line:

      AEAREP-xxx Data and Code Deposit for P&P submission accepted
      
    • Content:

      Thank you for uploading your code and data. This
      deposit is accepted. No computational verification was
      conducted, only compliance with required metadata was checked.
      
  • Select “Contact Owner”

From: dataeditor@aeapubs.org Subject line:

AEAREP-xxx Data and Code Deposit for P&P submission accepted

Message:

Thank you for uploading your code and data. This
deposit is accepted. No computational verification was
conducted, only compliance with required metadata was checked.

TBD

In Jira#

  • Move it through the workflow

    • Choose “Prepare for publication

    • Resolution: Evaluation only

    • MCRecommendationV2: Accept

If the form does not have all “required” elements checked, make the following entry#

  1. If Deposit Status = Deposit in Progress

  • Write a “Project communication log” entry

    • Subject line:

      AEAREP-XXX Modifications to make to your P&P deposit
      
    • Content:

      Thank you for uploading your code and data. We have
      checked the deposit for compliance with the required metadata
      elements. Please see the attached form for modifications to
      make.
      
    • Attach the PDF from the issue to the communication log.

  1. If Deposit Status = Submitted,

  • Change the status of the deposit to “Request Revisions” with the note:

    • Please see the attached form for modifications to make.

  • Write a “Project communication log” entry

    • Subject line:

      AEAREP-XXX Modifications to make to your P&P deposit
      
    • Content:

      Thank you for uploading your code and data. We have
      checked the deposit for compliance with the required metadata
      elements. Please see the attached form for modifications to
      make.
      
    • Attach the PDF from the issue to the communication log.

  • Tag Assistant to the Data Editor (Sofia) in the Jira ticket that there are noncompliant fields.

  • Tag Assistant to the Data Editor (Sofia) in the Jira ticket that there are noncompliant fields.

Back in Jira,#

  • Choose “Wait for openICPSR response (PandP)

    • Resolution: “Evaluation only

    • MCRecommendationV2 = “Accept with changes”

  • Later, once the issues have been resolved (typically days or weeks later) follow the process under “required elements checked”