How to Request a new DOI

1. The managing editor responsible for the Pull Request should send the following email to library.cataloguing@sussex.ac.uk cc-ing Tim Haillay <t.haillay@sussex.ac.uk> and Annette Moore <a.moore@sussex.ac.uk>

   Using the subject line Programming Historian DOI request:

   To Sussex Library Cataloging,

   We would like to request a new DOI for a forthcoming article in:

   • [SELECT APPROPRIATE LINE]
   • The Programming Historian (ISSN 2397-2068)
   • The Programming Historian en español (ISSN 2517-5769)
   • The Programming Historian en français (ISSN 2631-9462)
   • The Programming Historian em português (ISSN 2753-9296)

   Sincerely,

   [MANAGING EDITOR NAME]

2. Sussex will respond with a DOI string that will look something like 10.46430/phen0089. Add a new YAML header field to the lesson PR and paste in the DOI precisely:

   doi: 10.46430/phen0089
   

3. Once all checks have passed and the PR has been approved by relevant reviewers, merge the PR.

4. VERY IMPORTANT: Wait 5-10 minutes until you are able to load the new lesson at its public URL. The XML is generated and published at the same time, and we need to make sure it's been updated publicly before moving on to the next step.

5. Respond to Sussex's email:

   The article with DOI [NEW DOI HERE] is now published. Please resubmit our publication XML to CrossRef:

   • [PICK APPROPRIATE LANGUAGE LINK]
   • https://programminghistorian.org/en/crossref.xml
   • https://programminghistorian.org/es/crossref.xml
   • https://programminghistorian.org/fr/crossref.xml
   • https://programminghistorian.org/pt/crossref.xml

6. Sussex will reply once the upload has completed.

   • In the unlikely event there are validation errors, they will email you as well as our shared programminghistorian@gmail.com account. Please alert the technical team if this occurs.
   • If they reply that the upload was successful, confirm that the DOI correctly redirects to the published lesson. Then celebrate!