-
Notifications
You must be signed in to change notification settings - Fork 228
Maintenance Workflow
Contents of this page:
Any user/PH Team member/Editor/Editor of Translation/Managing Editor may report a bug. The options for how to do so, are outlined here.
-
Upon receiving a report, our Publishing Assistant will open an Issue on GitHub. She will then carry out an initial assessment to confirm whether the bug reported represents an error caused by the user (editing the lesson's code or changing its dataset, for example) or an error within the lesson itself.
a) If the former, our Publishing Assistant will close the Issue.
b) If the latter, our Publishing Assistant will re-test the relevant part(s) of the lesson and undertake research to identify a fix, step 2). -
Publishing Assistant will assess, test and research a fix. As part of this process, she may contact extended members of the Programming Historian team and (if appropriate) the author, to ask for advice.
a) If the Publishing Assistant can identify a fix, she will propose a solution and generate a Pull Request to edit the lesson appropriately, moving to step 5).
b) In the case that the Publishing Assistant cannot identify a fix, she will move to step 3).
-
a) Publishing Assistant will propose adding a warning to the lesson explaining that some users may encounter an error. Where possible, this warning should include links to further reading, empowering users to identify a solution themselves. She will generate a Pull Request to edit the lesson appropriately, then move to step 5).
or
b) Publishing Assistant will proceed to check budget for an external practitioner to carry out an assessment. If budget is available, the Publishing Assistant will contact an external practitioner (list to be kept below on this Wiki page), agreeing a fee and the standard terms of service, moving to step 4).
Note: External assessors will be hired as sole traders for individual pieces of work, and will not be employees of ProgHist ltd. The Publishing Assistant will remain external assessors' point of contact.
-
a) If the external assessor can identify a fix, they will propose a solution and generate a Pull Request to edit the lesson appropriately, moving to step 5).
b) In the case that the external assessor cannot identify a fix, they may propose adding a warning to the lesson explaining that some users may encounter an error. Where possible, this warning should include links to further reading, empowering users to identify a solution themselves. External assessor or Publishing Assistant will generate a Pull Request to edit the lesson appropriately, moving to step 5).
Note: If the lesson is written in Spanish, French or Portuguese, the relevant team will be assigned as 2nd Reviewers.
c) Either way, the external assessor submits their invoice to the Finance Manager via [email protected].
Note: Invoices must include the title of the lesson.
-
At this stage, the appropriate Managing Editor will review the proposed solution, and advise either:
a) they are happy with the fix and can Approve the Pull Request
b) they are happy with the warning and can Approve the Pull Requestor
c) (as a last resort) and drawing upon our retirement policy, that it would be better to retire the lesson.
Note 1: Depending whether the agreed solution represents a minor/major change to a lesson or its retirement, it will be important to consider our DOI Policy as well as the possibility that additional translation work may be required.
Note 2: In the case that the agreed solution represents a minor/major change to a lesson, our Publishing Assistant will add a link from our Wiki page outlining our DOI Policy to the Issue in question. The objective is to provide examples of changes deemed 'minor' and 'major' changes, so that future decisions are consistent.
This workflow will be revisited at least once per year at the ProgHist Ltd AGM.
English & French
Spanish
- Jairo Melo
English
<div class="alert alert-warning">
This lesson is under maintenance. Learn more in <a href='LINK'>Issue XXX</a> where we are discussing the problem, and contribute if you can!
</div>
Español
Français
<div class="alert alert-warning">
Cette leçon est en cours d'entretien. Apprenez-en plus dans l'<a href='LIEN'>Issue XXX</a> où nous discutons du problème, et contribuez si vous le pouvez !
</div>
Português
- Copyediting
- Copyedit comments
- Typesetting
- Archival Hyperlinks
- Copyright
- DOI
- Gallery image
- Checklist comment
- Handover comment
- Closing comment
- Opening comment Phase 0
- Phase change comment 1 to 2
- Phase change comment 2 to 3
- Phase change comment 3 to 4
- Opening comment Phase 4
- Phase change comment 4 to 5
- Phase change comment 5 to 6
- Phase change comment 6 to 7
- Tracking lesson phase changes
- Organisational Structure
- Trustee Responsibilities
- Trustee and Staff Roles
- Services to Publications
- Funding
Training
- Onboarding-Process-for-New-Editors
- Leading-a-Shadowing-process
- Board-of-Director---Continuing-Development
The Ombudsperson Role
Technical Guidance
- Making Technical Contributions
- Creating Blog Posts
- Service Integrations
- Brand Guidelines
- French Translation Documentation
- Technical Tutorial on Translation Links
- Technical Tutorial on Setting Up a New Language
- Technical Tutorial on Search
- Twitter Bot
- Achieving-Accessibility-Alt-text-Colour-Contrast
- Achieving-Accessibility:-Training-Options
Editorial Guidance
- Achieving Sustainability: Copyediting, Typesetting, Archival Links, Copyright Agreements
- Achieving Sustainability: Lesson Maintenance Workflow
- Achieving Sustainability-Agreed-terminology-PH-em-português
- Training and Support for Editorial Work
- The-Programming-Historian-Digital-Object-Identifier-Policy-(April-2020)
- How to Request a New DOI
- Service-Agreement-Publisher-and-Publications
- ProgHist-services-to-Publications
- Technical Tutorial on Setting Up a New Language
- Editorial Recruitment
Social Guidance
Finances
- Project Costs
- Spending-Requests-and-Reimbursement
- Funding Opportunities
- Invoice Template
- Donations and Fundraising Policies
Human Resources
- Privileges-and-Responsibilities-of-Membership
- Admin-when-team-members-step-down
- Team-Leader-Selection-Process
- Managing-Editor-Handover
- Checklist-for-Sabbaticals
- New Publications Policy
- Parental-Leave-Policy
Project Management
Project Structure
Board of Trustees