programminghistorian · anisa-hawes · May 2, 2025 · May 2, 2025 · May 2, 2025 · May 2, 2025
diff --git a/_data/snippets.yml b/_data/snippets.yml
@@ -179,14 +179,14 @@ menu-contribute-translate:
     link: /pt/directrizes-tradutor
 menu-contribute-edit:
   en:
-    title: Editor Guidelines
-    link: /en/editor-guidelines
+    title: Publishing Workflow
+    link: /en/publishing-workflow
   es:
     title: Guía para editores
     link: /es/guia-editor
   fr:
-    title: Consignes aux rédacteurs
-    link: /fr/consignes-redacteurs
+    title: Processus de Publication
+    link: /fr/processus-de-publication
   pt:
     title: Diretrizes para editores
     link: /pt/directrizes-editor

diff --git a/en/contribute.md b/en/contribute.md
@@ -31,7 +31,7 @@ If you would like to contribute as a peer reviewer, please take a few minutes to
 <img src="{{site.baseurl}}/gallery/editor-guidelines.png" class="garnish rounded float-right" alt="{{ site.data.snippets.editor-guidelines-image-alt[page.lang] }}"/>
 
 
-Our editorial board members help facilitate peer review and work with authors closely to make improvements to their lessons. Our [guidelines for editors](editor-guidelines) is meant to ensure that everyone, from authors to reviewers to members of the wider community, receive a fair and consistent experience during peer review.
+Our editorial board members help facilitate peer review and work with authors closely to make improvements to their lessons. Our [publishing workflow](publishing-workflow) is meant to ensure that everyone, from authors to reviewers to members of the wider community, receive a fair and consistent experience during peer review.
 
 From time to time we may advertise that we are seeking more editors.
 

diff --git a/en/editor-guidelines.md b/en/editor-guidelines.md
diff --git a/en/publishing-workflow.md b/en/publishing-workflow.md
@@ -0,0 +1,86 @@
+---
+title: Publishing Workflow
+layout: blank
+redirect_from: /editor-guidelines
+---
+
+{% include toc.html %}
+
+# Publishing Workflow
+
+Our publishing workflow moves through eight phases: **Proposal**, **Submission**, **Initial Edit**, **First Revision**, **Open Peer Review**, **Second Revision**, **Sustainability + Accessibility**, and **Publication**. The development of both original and translated lessons is supported by the professional services of our publishing team, guided by our managing editors, with the expertise of a cohort of volunteer editors from our project team.
+
+## Overview of Phases, Responsibilities, and Timeframes
+
+| Phase                            | Who is responsible?                    | Expected timeframe:                  |
+| -------------------------------- | -------------------------------------- | ------------------------------------ |
+| **0 Proposal**                   | Managing editor + their editorial team | 14 days feedback <br> 60 days submission |
+| **1 Submission**                 | Publishing team                        | 7 days  |
+| **2 Initial Edit**               | Editor                                 | 30 days |
+| **3 First Revision**             | Author/translator + editor             | 30 days |
+| **4 Open Peer Review**           | Reviewers + editor                     | 30 days |
+| **5 Second Revision**            | Author/translator + editor             | 30 days |
+| **6 Sustainability + Accessibility** | Publishing team (+ copyeditor _original lessons only_)         | 21-30 days |
+| **7 Publication**                | Managing editor + publishing team      | 14 days |
+
+## Details of Phases, Responsibilities, Timeframes, and Processes & Activities
+
+### Phase 0 Proposal 
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Managing editor + their editorial team | 14 days feedback <br> 60 days submission | * Managing editor receives proposal forms.<br>* Proposal forms are circulated for feedback from the editorial team within 14 days.<br>**Note:** Proposals are considered on the basis of how well they serve the needs of the community, and whether they support our journal’s ambitions of **openness**, **global access**, **multilingualism** and **sustainability**.<br>* Managing editor replies to authors/translators to either reject the proposal and share feedback, or invite submission.<br>* Managing editor opens a new GitHub issue to represent the successful proposal, assigning an editor, and agreeing a submission date within 60 days.<br>**Note:** This issue will provide a space for communication and collaboration throughout the publishing workflow. Labels will be used to indicate the lesson’s progress. The publishing team will post a comment at the beginning of each phase to clarify _What’s happening now?_
+
+### Phase 1 Submission
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Publishing team | 7 days | <ul><li>Publishing team receives and processes submission materials.</li><li>Markdown files are checked, and key elements of metadata are added.</li><li>Figures are resized and renamed according to our requirements and conventions</li><li>Data assets are checked and processed.</li><li>Publishing team post a comment to the GitHub issue, providing locations of all key files, as well as a link to a live ‘in browser’ preview, where contributors will be able to read the lesson as the draft progresses.</li><li>Publishing Manager sends new contributors an invitation to join the repository as Outside Collaborators, granting them direct write access.</li><li>Publishing team will liaise with author/translator to resolve any queries raised during file processing, and to work through any initial adjustments required.</li></ul>
+
+
+### Phase 2 Initial Edit 
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Editor | 30 days | <ul><li>Editor reads the submission, considering how well it meets our journal’s ambitions of **openness**, **global access**, **multilingualism** and **sustainability.**</li><li>Editor considers the lesson’s level of **difficulty** against our [matrix](/ph-submissions/wiki/Phase-2-Initial-Edit#difficulty-matrix).</li><li>Editor shares initial feedback as a comment in the GitHub issue, anchoring specific comments to sections or paragraphs (referring to numbers at the right margin of the lesson preview) to support the author’s/translator’s revisions in Phase 3.</li></ul>
+
+
+| Our principles | Key considerations |
+| -------------------------------- | ------------------------------ | 
+| **Openness**                         | <ul><li>Does this lesson centre open source software, open programming languages, and open access datasets? If the method involves any proprietary software or commercial tools, we strongly recommend authors present these alongside open source alternatives, and cost-free options.</li> |  |
+| **Global access**                    | <ul><li>Does this lesson outline technical prerequisites clearly, and consider potential limitations of access to methods, software or tools? Remind authors that our readers work with different operating systems and have varying computational resources.</li> <li>Is accessibility embedded within lesson? Our readership have different abilities, and varying access needs. Directive language should avoid using sight as a metaphor for understanding; visuals, plots, and graphs must be accompanied by concise captions, and `alt-text`; tabular data and code must be provided in Markdown and raw form.</li>  |  |
+| **Multilingualism**                  | <ul><li>Has the author chosen methods, tools, and datasets that can be applied or adapted for use in languages other than English? Our strong preference is to publish lessons that will be practicable in multilingual research-contexts, and future translation.</li> <li>Has this author attempted to localise their translation by replacing datasets or case study examples with materials in the translation language to improve usability for the new audience?</li> <li>If this is a translation _to English_, encourage the author to keep non-English datasets and case study examples in place, to help our Anglophone communities learn to work with multilingual data and research materials.</li> |  |
+| **Sustainability**                   | <ul><li>Does this lesson successfully prioritise reflections, contextual discussions and overviews of practical steps over click-by-click instructions? This emphasis helps to ensure lessons remain useful beyond present-day graphical user interfaces and current software versions. Encourage authors to anticipate challenges readers may face, and guide troubleshooting.</li> <li>Does the author specify which computational environment, programming languages, packages and software versions the lesson has been developed for and tested within?</li> <li>Ask authors to include clear citations to case study sources, datasets, and software.</li> |  |
+
+### Phase 3 First Revision 
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------- |
+| Author/translator + editor | 30 days | <ul><li>Editor + author/translator agree a timeframe for the author/translator to make the suggested revisions (30 days is usually reasonable).</li><li>Author/translator revises the lesson.</li><li>Author/translator posts a comment in the issue to confirm when the revised draft is ready for the editor’s review.</li><br>**Note:** Revision is a collaborative process, involving dialogue. The depth of editorial work involved will vary from lesson to lesson.<br><br><li>Editor begins coordinating peer reviewers to participate in Phase 4. The first step is to systematically contact the publishing assistant, who will provide the details of available reviewers from our pool of volunteers. If there are none, the managing editor can support the editor to make direct approaches.</li><li>We are committed to inviting a broad range of community perspectives, and we strive to maintain a diversity of gender, nationality, race, age, and academic background among our contributors. Open Peer Review should remain an inclusive space in which peers can teach and learn from each other generously, as equals.</li></ul>
+
+
+### Phase 4 Open Peer Review
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Reviewers + editor | 30 days |  <ul><li>Reviewers share their feedback as a comment in the issue thread within 60 days.</li><li>Editor summarises the two reviews so that the author/translator has a clear sense of the revisions to work through in Phase 5.</li></ul>
+
+
+### Phase 5 Second Revision
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Author/translator + editor | 30 days | <ul><li>Editor + author/translator agree a timeframe for the author/translator to make the suggested revisions (30 days is usually reasonable).</li><li>Author/translator revises the lesson.</li><li>Author/translator posts a comment in the issue to confirm when the revised draft is ready for the editor’s review.</li><li>Editor re-reads the lesson to confirm that all agreed revisions are complete.</li><li>Managing editor reads the lesson to confirm if it should be moved to Phase 6.</li></ul>
+
+
+### Phase 6 Sustainability + Accessibility
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Publishing team (_+ copyeditor original lessons only_) | 21-30 days |  <ul><li>Copyediting (_original lessons only_) to check the text for clarity of expression, typing mistakes and grammatical errors.</li><li>Typesetting to ensure consistent layout.</li><li>Generating archival hyperlinks.</li><li>Checking of files and metadata.</li><li>Assigning a DOI.</li><li>Collating copyright agreements.</li></ul>
+
+### Phase 7 Publication
+
+| Who is responsible?                     | Expected timeframe                |   Process & activities               |
+| -------------------------------- | ------------------------------ | ------------------------------  |
+| Managing editor + publishing team (+ editor _post-publication_) | 14 days | - Publishing Manager stages files for publication.<br>- Managing Editor re-reads the lesson, to provide final feedback or suggest additional revisions.<br>- Managing editor approves the lesson for publication.<br>- Publishing team initiates announcement + schedule promotion of the new lesson.<br>- Publishing team shares suggested citation + social media announcement links with all contributors to close the issue.
diff --git a/es/guia-editor.md b/es/guia-editor.md
@@ -1,7 +1,7 @@
 ---
 title: Guía para editores
 layout: blank
-original: editor-guidelines
+original: publishing-workflow
 ---
 
 # Guía para editores

diff --git a/fr/apropos.md b/fr/apropos.md
@@ -10,7 +10,7 @@ original: about
 ## Évaluation par les pairs
 Tous les tutoriels du _Programming Historian en français_ sont rigoureusement évalués par des pairs, la procédure étant suivie par un rédacteur ou une rédactrice de notre équipe. L'évaluation implique des échanges approfondis avec la personne responsable de la leçon avant l'envoi aux experts externes pour s'assurer, d'une part, de la cohérence du tutoriel selon les objectifs préalablement fixés, d'autre part, que tous les concepts sont suffisamment explicites pour un lectorat non-spécialiste.
 
-Notre procédure d'évaluation par les pairs est un peu différente de celle qui peut être considérée comme traditionnelle. Nous ne sollicitons pas des expertises afin de juger si un tutoriel est "suffisamment bon" pour être publié. De notre point de vue, la procédure d'évaluation fait plutôt partie intégrale d'un effort collaboratif, productif et durable d'enseignement et d'apprentissage réciproque entre universitaires. Une fois qu'un tutoriel entre dans notre [flux éditorial]({{site.baseurl}}/fr/consignes-auteurs), nous ne nous épargnons aucun effort pour le rendre le plus utile possible et le publier dans des délais raisonnables. Merci de consulter nos [consignes aux rédacteurs]({{site.baseurl}}/fr/consignes-redacteurs) pour plus d'informations.
+Notre procédure d'évaluation par les pairs est un peu différente de celle qui peut être considérée comme traditionnelle. Nous ne sollicitons pas des expertises afin de juger si un tutoriel est "suffisamment bon" pour être publié. De notre point de vue, la procédure d'évaluation fait plutôt partie intégrale d'un effort collaboratif, productif et durable d'enseignement et d'apprentissage réciproque entre universitaires. Une fois qu'un tutoriel entre dans notre [flux éditorial]({{site.baseurl}}/fr/processus-de-publication), nous ne nous épargnons aucun effort pour le rendre le plus utile possible et le publier dans des délais raisonnables. Merci de consulter nos [processus de publication]({{site.baseurl}}/fr/processus-de-publication) pour plus d'informations.
 
 
 ## Open Source (code source ouvert)