-
Notifications
You must be signed in to change notification settings - Fork 228
Service Integrations
Matthew Lincoln edited this page Jun 18, 2020
·
72 revisions
While the content of The Programming Historian is tracked and hosted on GitHub, we do use several non-GitHub services to aid our editorial and publishing process.
- [email protected] (please do not email this box as it is not monintored)
- purpose: to provide a shared email box that these service integrations can be linked to.
- maintained by @acrymble and linked to his phone number. Recovery email address is [email protected]
- at present the following people know the password: @acrymble, @drjwbaker, @walshbr, @amsichani, @mariajofana. Any team members who want to know please contact one of those people (you are all welcome to know it)
- [email protected]
- purpose: for internal emails only for members of the editorial board
- Connected to [email protected] account.
- maintained by @jenniferisasi.
Additional Google Groups for teams:
-
purpose: for internal emails of Project Development Team
-
maintained by @acrymble.
-
purpose: for internal emails of English Publication
-
maintained by @svmelton.
- purpose: to provide catalogue entries of lessons that can be added easily to library catalogues.
- maintained by: @drjwbaker
- notes for transfer
- March and September each year.
- Login in at https://doaj.org/publisher/ (linked to [email protected])
- Sort existing entries by date at DOAJ (e.g. https://doaj.org/toc/2397-2068) and identify new lessons: for EN https://programminghistorian.org/en/lessons/?sortType=date&sortOrder=desc, for ES https://programminghistorian.org/es/lecciones/?sortType=date&sortOrder=desc
- Manually enter at https://doaj.org/publisher/metadata. Be sure to note volume number from 2019 onwards (note done for 2018 as volume numbers implemented half way through the year). For abstract, use a logical combination of header abstract and introduction.
- purpose: Dead link and YAML checking
- maintained by: @ZoeLeblanc
- notes for transfer: No password needed. New admin would need to authorize Travis CI to access their GitHub account.
- purpose: live web previews of pull requests
- maintained by: @ZoeLeblanc
- Login is limited to the technical team lead (for maintenance) and the finance manager (for paying occasional charges for build minutes, etc.)
- purpose: to tweet about news and content
- maintained by @acrymble, @walshbr (administrators)
- All members of the editorial board should have tweeting access. contact @acrymble if you don't.
- The account is linked to the following email: [email protected]
- purpose: Pre-compose tweets
- maintained by: @walshbr (with @mdlincoln and @jerielizabeth as collaborators on Heroku account)
- notes for transfer: App is hosted at Heroku, which requires a Heroku account (currently linked to the Programming Historian gmail). The app uses Twitter credentials (the ProgHist Twitter account) as well as a Google Sheets keychain that exists can generated from the Google Cloud Console - instructions on the repo for the Programming Historian Bot. New admin would need to generate new custom keychain for Google Sheets, and ensure they have push privileges to Heroku.
- purpose: Monitor site traffic
- maintained by: @acrymble, also linked to [email protected] account
- notes for transfer: New administrative access and user management accessible via the above email account.
- purpose: Gives us the custom url
programminghistorian.org
- maintained by: Jessica Otis [email protected]. If contact required, email Jessica cc'ing [email protected] (center administrator) or [email protected] (systems administrator).
- purpose: Provides HTTPS
- maintained by: @mdlincoln
- notes for transfer: Current admin removes
programminghistorian.org
from their Cloudflare account, allowing a new admin to add it to their Cloudflare account.
- purpose: deposit location for project citation.
- maintained by: @drjwbaker
- notes: annual (each November). Use process at https://guides.github.com/activities/citable-code/ to create a deposit from https://github.com/programminghistorian/jekyll. Latest deposit at https://doi.org/10.5281/zenodo.3525082.
- purpose: accepting donations
- maintained by: @drjwbaker, linked to [email protected] account
- notes: password same as DOAJ (@acrymble knows this as well). Linked to Paypal for scheduled check out 5th of each month.
- activities:
- @drjwbaker emails @jenniferisasi a list of supporters every Monday morning London time, @jenniferisasi then tweets the list Monday morning US central time
- @drjwbaker curates a list of supporters and shares it with @jenniferisasi on the ticket for the newsletters
- @acrymble to request list of 'Patron' tier supporters who can suggest lesson topics.
- purpose: accepting donations and processing Patreon
- maintained by: @drjwbaker, linked to [email protected] account
- notes: password held by @drjwbaker. If you need to get in, do a password reset via [email protected].
- purpose: publishing PH workshop video materials
- maintained by: @mariajoafana, linked to [email protected] account
- notes: password same as gmail account
- purpose: archive of project (e.g. bids or internal surveys) and business (e.g. incorporation) documents that we deem necessary to keep private from the public but to which the Editorial Board need periodic access (e.g. when writing bids, talks, or papers) https://github.com/programminghistorian/project-and-business-archive
- maintained by: @drjwbaker
- note: document containing sensitive and private financial information are held offline, a listing for which is at /project-and-business-archive/business/Finances/. Access requests can be made by contacting @drjwbaker.
- 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