Chapter 20. Anthology Release

This chapter of our documentation is still in beta. We welcome feedback, corrections, and questions while we finalize the page in our 2024–2025 work cycle.

Introduction to Anthology Releases

Rationale

The Anthology Release documentation is designed to support you as you get close to releasing your anthology. It will guide you through the release process and associated tasks and responsibilities.

Vocabulary

We use the term freeze frequently in our Anthology Release documentation. Freeze is a period before an anthology release during which no new content should be added to the files that you will publish and no major revisions should be made. During this period, your anthology team will ensure that all pages are ready to be published. We will likely refer to your anthology being frozen during this period. This simply means that your anthology is in the state described above: there is no new content being added to it and there are no major revisions being made.

Release Step-by-Step

The following are the steps that must be completed before an anthology can be released, given in the order that they should be completed in and including the people responsible for each step:
Determine which files will be published in the release. (Anthology leads.)
Finish adding content to and encoding the files that will be published. (Anthology leads, editors, and encoders.)
Create a pre-freeze progress chart. (Anthology leads with support from the LEMDO team.)
Plan the timeline for freezing your anthology. (Anthology leads with support from the LEMDO team.)
Communicate your timeline with the LEMDO team and your anthology. (Anthology leads.)
Complete pre-freeze tasks. (Anthology leads, editors, and encoders.)
Inform the LEMDO director that you are ready to freeze your anthology. (Anthology leads.)
LEMDO announces the freeze. There should be no new content added or major revisions from this point on. (LEMDO team.)
Create a release progress chart. (Anthology leads with support from the LEMDO team.)
Complete pre-release tasks. (Anthology leads, editors, encoders, and the LEMDO team.)
LEMDO publishes the release. (LEMDO team.)
These steps will be further broken down in this chapter of documentation.

Content

Release Process and Timelines: This page is designed for anthology leads planning an upcoming release.
Before an Anthology Freeze: This page is designed for editors, encoders, and anthology leads who are preparing for a release.
Freeze: This page is designed for editors, encoders, and anthology leads in the final stages before publication.
Publish and Evaluate Your Anthology Release: This page is designed for editors, encoders, and anthology leads who wish to learn more about the actual publication and evaluation of an anthology release.

Release Process and Timelines

This page is designed for Anthology Leads (the Coordinating Editors of the NISE, DRE, or MoMS anthologies; the General Editors of the QME, EMEE, DRD, EMDP, and Douai anthologies).

Rationale

Having a clear understanding of the release process and reasonable expectations for the amount of time that each step of the process takes can make the release process go more smoothly and run on schedule. This documentation is designed to give you an overview of the anticipated process and timeline for an anthology release based on the LEMDO teamʼs publication experiences. We recommend consulting it as you plan your anthologyʼs release.
Note that the size of your release will impact the amount of time that the run-up to release takes; a smaller release will take less time than a larger release. You must notify the LEMDO Team at least two calendar months ahead of your desired release date. The feasibility of your release will depend on other tasks in the LEMDO Teamʼs workflow. The precise release date and time will depend on our developersʼ availability.

Practice: Determine Files to be Published

Before you can plan what needs to be done to ensure that your files are ready to be published, determine which files and editions you will include in your release. These should be files and editions that are either already complete or that are near completion and have people working on them. You should be in communication with your editors so that you can anticipate when they will be finished work on their editions.
LEMDO recommends doing fairly small releases, especially for your anthologyʼs first release. By publishing only a few editions at a time, you will reduce the amount of work that your anthology needs to do and the amount of time that it takes to complete that work during the release process.
Your anthology will include only the editions that you select to be published by including them in your anthologyʼs TEI Corpus file (the file in your anthology portfolio with an @xml:id value identical to your anthology ID; e.g., moms.xml). Only files that have a value of published on the @status attribute of their <revisionDesc> can be published.
Once you have determined the files that you want to publish, let the LEMDO Team know that you would like to prepare for a website release. Let us know at least two months in advance of when you would like to publish.

Practice: Pre-Release

Minimum Two Months Ahead of Release Date

Notify the LEMDO Team of your desired release date and which editions you intend to include.
Determine which files you are going to publish in your upcoming release.
Finalize content in the files you are going to publish: enter revisions arising from the peer-review process, check citations and references, and ensure that you have made all the links you want to make.
Call for updated bios from contributors, if necessary.

One Month Ahead of Release Date

Create a pre-freeze progress chart that lists all the files you are publishing or updating in this release. Having this chart will help you to determine a timeline for your freeze and ensure that you do not miss any required tasks. People often notice errors and omissions during this stage; anticipate that it will take a full month to complete your pre-freeze tasks. For more information on pre-freeze tasks (including creating a pre-freeze progress chart), see Before an Anthology Freeze.
Proofread pages.
Standardize metadata across all pages.
Write release notes.
Let the LEMDO Director know when you are close to being ready to freeze your anthology. The LEMDO team can then support you to plan a timeline for the freeze. It is important that your team knows when the freeze will be and what it entails to ensure that they understand that they can add no new content during the freeze and that they complete their pre-freeze tasks on time. For more information on freezes, see Freeze.

One Week Ahead of Release: Freeze Tasks

When you are nearly finished with your pre-freeze tasks, you create a final release progress chart. Share it with your team after you have completed all of your pre-freeze tasks. These tasks include:
Check the metadata for each Web page.
Proofread to correct any glaring errors.
Click every link on each Web page.
Change the status of each page to published.
For more information about the tasks to be done during the freeze and on creating your final release progress chart, see Freeze.
The LEMDO director will announce the freeze when you have finished your pre-freeze tasks. There should be no new content added or major revisions made from this point on.
This stage typically takes about a week. We prefer to publish early in the week (on Mondays when possible) to ensure that we are able to give the release our full and unrushed attention. To allow your team a full week for the freeze period, plan to freeze your anthology at the end of a work week and to complete your final release tasks at the end of the following week.

One Day Ahead of Release

The LEMDO team will take over once you have completed your final release tasks during the freeze. We will do a final check to ensure that your anthology is ready to be published, then we will publish your beta site.
There are sometimes final corrections to be made in this stage. You can anticipate that it will take about a day to release your site. We prefer to publish early in the week; please plan to be done your final release tasks by Monday morning of the week that you wish to publish your anthology.

Practice: Evaluate Your Release

(One month)
LEMDO will do a release evaluation and report after your anthology has been published. Your role in this stage of the release process is to respond to release questionnaires that the LEMDO Project Manager emails you. The Project Manager will incorporate all team membersʼ questionnaire responses into the our release report. All questionnaire responses will be anonymous. This in turn allows us to evaluate what went well during the release process, and what we can improve on in future releases. The LEMDO Project Manager will send you the final release report when it is complete.
Anticipate that it will take about one month for you to receive the release report after your anthology has been released. For more information about the publication and evaluation of your anthology, see Publish and Evaluate Your Anthology Release.

Before an Anthology Freeze

Rationale

There are a number of tasks that must be completed before your anthology can be released. We have grouped the tasks into two main groups: tasks that should be completed before your anthology freeze and tasks that must be completed during your anthology freeze. This documentation explains the tasks that should be done before your anthology is frozen (i.e., before the point when your anthology leads and the LEMDO team determine that there should be no new content or major revisions made to any files in your anthology).

Create a Pre-Freeze Progress Chart

For Anthology Leads: Once you have determined which files will be published with this release, work with the LEMDO Project Manager to create a progress chart to ensure that all of the required tasks are completed before your anthology is released. Email the LEMDO Project Manager at lemdopm@uvic.ca.
You are responsible for adding any outstanding encoding tasks to the pre-freeze progress chart. Use your anthology status report to check for major encoding errors that you must correct. We also recommend looking at each file that you are planning to publish to check for comments and obvious encoding errors.
You are also responsible for adding your anthologyʼs desired metadata format to the bottom of the pre-freeze progress chart file. For more information on encoding metadata, see Chapter 19. Metadata.

Finish Encoding Files

All outstanding encoding tasks must be completed and comments in files should be resolved before your anthology is frozen. Additionally, all anthology diagnostics for the files that you wish to publish should be cleared during this phase. Follow the instructions in your anthologyʼs pre-freeze progress chart to complete the encoding tasks assigned to you.

Copyedit Pages

Complete all remaining copyediting. Remember that this is the last time that you should be making any significant revisions to the content of any files—the freeze period is for correcting only glaring errors. We recommend proofreading each file on your anthologyʼs alpha site while having the XML files open to make any necessary corrections.
When copyediting your anthology bibliography and edition bibliographies, check that entries are correctly ordered and follow LEMDOʼs practice for formatting bibliographies. See Chapter 10. Bibliography and Citation Guidelines for more information.

Check All Metadata

We recommend checking the metadata for each of your files using both of the following methods:
Check metadata in your XML files.
Check the rendering of metadata on your anthologyʼs alpha site.
Your anthology lead should have added your anthologyʼs desired metadata format to the bottom of your pre-freeze progress chart file. Ensure that the encoding and content match that format for each file.

Freeze

Freeze is a period before an anthology release during which no new content should be added to the files that you will publish and no major revisions should be made. During this period, your anthology team will ensure that all pages are ready to be published.

Rationale

LEMDO will freeze your anthology before it is published. This period is used to ensure that there are no glaring errors in any of the pages being published, that all pages have complete metadata, and that all links on your anthology website work correctly.

Create a Final Release Progress Chart

For Anthology Leads: When you are nearing freeze, work with the LEMDO Project Manager to create a progress chart to ensure that all of the required tasks are completed before your anthology is released. Email the LEMDO Project Manager at lemdopm@uvic.ca.

Look Through the On This Page Hamburger Menu

Each page on your anthology site has an On This Page hamburger menu accessible by clicking the button with three horizontal lines in the top left corner of the page. Click through each of the buttons in that menu (Content, Credits, Tools, and About). If there are links in any of those, click each of the links to ensure that they work.

Check Metadata

Navigate to the About tab in your pageʼs On This Page hamburger menu and select Metadata. Ensure that there is data in each of the metadata fields. If there are any empty fields in your pageʼs metadata, go to the bottom of your anthologyʼs pre-freeze progress chart file to find the correct format for metadata and add the appropriate information to your pageʼs XML file.

Proofread and Change Status

When you proofread your pages, check for glaring errors (missing spaces, missing or extra punctuation, spelling errors). Avoid making any major revisions to content at this point; all major revisions should be made well before the freeze.
To change your fileʼs @status value, follow these steps:
Change the value on the @status attribute on the <revisionDesc> element to TEI_proofed or IML-TEI_proofed.
Add a new <change> element to the <revisionDesc> .
Add a @who attribute with the value pers: followed by your xml:id.
Add a @when attribute with the date that have proofed the page.
Add a @status attribute with the value TEI_proofed or IML-TEI_proofed.
By changing the status of your file to TEI_proofed or IML-TEI_proofed, you are indicating that the page is ready for your publisher (LEMDO) to publish the page. Note that these changes should be completed at least one full day before your anthology is published.

Publish

The final step before we release your site is undertaken by the LEMDO Team. The LEMDO Team will do a final check of your anthology and all the pages you want to publish in the next release. You should plan to have completed all of your final release tasks at least one full day before your anthology is published. That gives the anthology time to build and be checked on the day of publication.
Then LEMDO Team will do the following:
Change the value on the @status attribute on the <revisionDesc> element of each file to published.
Add a @who attribute with a value of org:LEMD1 to indicate that it is LEMDO that is publishing the file.
Add a @when attribute. The value of @when will be the date that we are publishing your anthology.
Add a @status attribute with the value published.
If there is an earlier <change> element with a @status value of published, we will remove the @status but retain the rest of the <change> element. We will note the initial date of publication in the text node of that <change> element if the file has been previously published.
We want only one <change> element with @status value of published. The objectives here are:
To have a single, citable publication date on the page in the release.
To retain a history of the page throughout the multiple releases of your anthology.

Publish and Evaluate Your Anthology Release

Rationale

The final two stages of your anthologyʼs release (publication and evaluation) are done by the LEMDO Team. This documentation is designed to help you understand this part of the process and know what to expect during these stages of your anthologyʼs release.

Anthology Publication

Once you have completed all of your final release tasks (see Freeze), the LEMDO Team will check to ensure that your anthology is completely ready for publication. Our programmer will then release a static version of your anthology on your anthologyʼs beta website. This means that the content of your anthologyʼs beta site will not change until your anthologyʼs next release. Releasing in this way follows the Endings Principles for Release Management.

Release Evaluation

Following an anthology release, the LEMDO Project Manager will create a report evaluating the release. This report will inform how LEMDO continues to improve our process for future releases. Your role in the evaluation process is to respond to the anonymous questionnaire that the Project Manager will send to those who worked on the release.
Our release evaluation reports include the following information:
A brief summary of the release.
The aims of the release, divided into the anthologyʼs aims and LEMDOʼs aims.
A list of activities performed by the anthology and LEMDO teams that resulted in the release.
A list of quantitative outputs (e.g., the number of editions published, the number of Web pages published, etc.)
A list of qualitative outputs compiled from the responses to the questionnaire sent out by the Project Manager. Responses will be anonymous in this report.
A table comparing the aims and outputs of the release.
Any further remarks about the release.
The Project Manager will share the release evaluation report with anthology leads when it is complete, typically 4–6 weeks after the release.

Prosopography

Isabella Seales

Isabella Seales is a fourth year undergraduate completing her Bachelor of Arts in English at the University of Victoria. She has a special interest in Renaissance and Metaphysical Literature. She is assisting Dr. Jenstad with the MoEML Mayoral Shows anthology as part of the Undergraduate Student Research Award program.

Janelle Jenstad

Janelle Jenstad is a Professor of English at the University of Victoria, Director of The Map of Early Modern London, and Director of Linked Early Modern Drama Online. With Jennifer Roberts-Smith and Mark Kaethler, she co-edited Shakespeare’s Language in Digital Media: Old Words, New Tools (Routledge). She has edited John Stow’s A Survey of London (1598 text) for MoEML and is currently editing The Merchant of Venice (with Stephen Wittek) and Heywood’s 2 If You Know Not Me You Know Nobody for DRE. Her articles have appeared in Digital Humanities Quarterly, Elizabethan Theatre, Early Modern Literary Studies, Shakespeare Bulletin, Renaissance and Reformation, and The Journal of Medieval and Early Modern Studies. She contributed chapters to Approaches to Teaching Othello (MLA); Teaching Early Modern Literature from the Archives (MLA); Institutional Culture in Early Modern England (Brill); Shakespeare, Language, and the Stage (Arden); Performing Maternity in Early Modern England (Ashgate); New Directions in the Geohumanities (Routledge); Early Modern Studies and the Digital Turn (Iter); Placing Names: Enriching and Integrating Gazetteers (Indiana); Making Things and Drawing Boundaries (Minnesota); Rethinking Shakespeare Source Study: Audiences, Authors, and Digital Technologies (Routledge); and Civic Performance: Pageantry and Entertainments in Early Modern London (Routledge). For more details, see janellejenstad.com.

Joey Takeda

Joey Takeda is LEMDO’s Consulting Programmer and Designer, a role he assumed in 2020 after three years as the Lead Developer on LEMDO.

Mahayla Galliford

Research assistant, remediator, encoder, 2021–present. Mahayla Galliford is a fourth-year student in the English Honours and Humanities Scholars programs at the University of Victoria. She researches early modern drama and her Jamie Cassels Undergraduate Research Award project focused on approaches to encoding early modern stage directions.

Martin Holmes

Martin Holmes has worked as a developer in the UVicʼs Humanities Computing and Media Centre for over two decades, and has been involved with dozens of Digital Humanities projects. He has served on the TEI Technical Council and as Managing Editor of the Journal of the TEI. He took over from Joey Takeda as lead developer on LEMDO in 2020. He is a collaborator on the SSHRC Partnership Grant led by Janelle Jenstad.

Navarra Houldin

Project manager 2022–present. Textual remediator 2021–present. Navarra Houldin (they/them) completed their BA in History and Spanish at the University of Victoria in 2022. During their degree, they worked as a teaching assistant with the University of Victoriaʼs Department of Hispanic and Italian Studies. Their primary research was on gender and sexuality in early modern Europe and Latin America.

Tracey El Hajj

Junior Programmer 2019–2020. Research Associate 2020–2021. Tracey received her PhD from the Department of English at the University of Victoria in the field of Science and Technology Studies. Her research focuses on the algorhythmics of networked communications. She was a 2019–2020 President’s Fellow in Research-Enriched Teaching at UVic, where she taught an advanced course on Artificial Intelligence and Everyday Life. Tracey was also a member of the Map of Early Modern London team, between 2018 and 2021. Between 2020 and 2021, she was a fellow in residence at the Praxis Studio for Comparative Media Studies, where she investigated the relationships between artificial intelligence, creativity, health, and justice. As of July 2021, Tracey has moved into the alt-ac world for a term position, while also teaching in the English Department at the University of Victoria.

Metadata