-
Notifications
You must be signed in to change notification settings - Fork 229
Various Guidance
Contents of this page:
This page offers guidance on how to navigate the various documents supporting our social media workflow, which can be found in the shared Social Media Documentation
Google Folder.
Further information available on the Posting Schedule Wiki page.
Part of our Checklist Comment asks us to prepare announcement posts to advertise the publication of a new lesson. The templates for these can be found on this page of the Wiki, as well as in the new-lesson-announcements
spreadsheet of the Google Folder.
We prepare two posts:
- one to be posted immediately upon publication
- one to be scheduled for ~21 days later
Two versions of each post must be drafted: one with the Bluesky usernames, the other with the Mastodon usernames. If these are unknown or unavailable, we simply write the Full Name.
We prepare these posts at the handover to Phase 7 and log them in the new-lesson-announcements
spreadsheet until they are ready to be posted or scheduled. Currently, only the Publishing Manager (Anisa) and Publishing Assistant (Charlotte) have 'editor' access to this spreadsheet.
One of Programming Historian's social media goals is to regularly promote lessons from our directory, in order to reinvigorate readership after publication.
We do this by asking the Managing Editor to prepare two 'evergreen' posts giving a brief hook for the lesson, which we log into two Google Sheets:
- in
ph-evergeens-bluesky
, we use the Bluesky usernames (or Full Name if unavailable) - in
ph-evergreens-mastodon
, we use the Mastodon usernames (or Full Name if unavailable)
All four Managing Editors as well as the Publishing Manager (Anisa) and Publishing Assistant (Charlotte) have 'editor' access to these spreadsheets.
The term "evergreen" suggests these posts should be shareable at any time, even months or years after publication. This means that they should not make any temporal references such as "new", "recently published", "now available", etc. We'd really like to tag the authors/translators as often as possible, so it's helpful to structure the post in a way that includes their names. Importantly, Bluesky has a 340 character limit: because we also include the DOI (~40 characters) and ideally one or two names (~15-30 characters), this only leaves around 250 characters for the actual content of the post. A number of usernames currently used in the evergreen spreadsheets are old Twitter usernames. It’s important to check them against the username log and to update them to Bluesky/Mastodon wherever necessary. Although MEs are asked to draft the posts during the Checklist Comment phase, this is often missed out. It can be necessary to chase up and send MEs a batch to draft at once. This Bluesky character counter tool is useful for drafting posts within the character limit.
We go through a third-party platform called Buffer, using the publishing.assistant [@] programminghistorian.org
address.
- Click on the relevant channel tab on the left of the homepage. If posting across both channels at once, click 'All channels'. You'll then be able to customise the post for each channel (e.g. usernames).
- Click the bright blue button to Create Post.
- Enter the content in the text box. You can select an image from any links included to display under the text.
- Click on the dropdown next to Add to Queue and select Schedule Post.
- Choose a date and time, and click Schedule!
We also keep a spreadsheet named username-log
, in which we record the Bluesky and Mastodon usernames of our Project Team members and our Contributors, to use as a reference when drafting new tweets in the future. This spreadsheet now also contains all Project Team email addresses.
- 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