"

Y2 Unit 6.2: Manuscript Development in Year 2

Author teams just completed an intense year of outlining, writing, and revising to get your manuscript ready to pilot. Authors should plan a break from the project during Year 2. You’ll work with the Project Manager to determine when, during the year, it makes sense to come back and make changes in your working documents.

At the end of Year 1, a draft of your manuscript reached the point that we call “pencils down.” That means no more edits to this version of your textbook so that reviewers, pilot instructors, and students have a stable textbook to work with this year. The leadership team moved this version into Pressbooks, our publishing platform. Your chapter docs are still working documents, but any changes you make there will not be reflected in the pilot edition of your book.

At the end of Year 1, you had to finish in the available time so that your book could be piloted with students. However, you very likely weren’t really done with your chapters. Now you have time to revisit your priorities. During Year 2, you will make four separate one-month passes through your chapter docs for important cleanup:

  • First pass: Re-read your chapters and fill content gaps
  • Second pass: Multimedia figures
  • Third pass: H5P development
  • Fourth pass: Cleaning up licenses, attributions, and references sections

Please plan to spend at least one month per pass. Your Project Manager will help you stay on track.

Year 2 Author Deadline

Each author must finish their work by the end of Year 2, Month 10. Because we’re asking you to make four 1-month passes through your chapters, this means that you must get started by the beginning of Month 7.

The most important thing you can do to improve your chapters this year is: don’t rush. Put time on your calendar during your scheduled time to work on this project so that you can engage at a regular cadence. Schedule check-ins with the Project Manager or other team members to keep yourself accountable. A writing group like VOWəL [Website] can also help you protect your writing time and stay accountable to your goals.

You could take one long break from Months 1-6 and then dive back in at Month 7. However, we recommend starting earlier and building in some breaks and cushions because life happens. Here is an example of what we mean by needing a cushion:

  • You give yourself a deadline of January 31 for one of your chapter passes.
  • Life happens and now it’s January 28 and you’re just getting started. However, we do not want you to cram a month’s worth of work into one weekend because that doesn’t honor all the effort you have put into this project so far.
  • Instead, contact the Project Manager and reschedule for a time that you have a whole month to spend on this pass.
  • If now is a good time, your new deadline will be February 28 so that you have a whole month to work.

Keep in mind, too, that you might start pulling on a loose thread and suddenly have more than a month’s worth of work in mind for one pass. For example, you might search for more diverse scholars to cite (Year 2, Unit 9) and see a way to rewrite an entire section foregrounding different perspectives. Or you might have a great media idea (Year 2, Unit 7) that would take more than 4 weeks of collaboration with a Media Developer to create. If it’s early in the year, you and your Project Manager may be able to build in time for new ideas. But the closer we are to the deadline, the more important it will be to limit your scope.

Manuscript Handoff to Revising Author and Early Adoption Instructors

The author team’s Year 2 goal is to further develop the manuscript so that it is in the best possible shape to hand off to the Revising Author and Early Adoption Instructors.

As we said above, we don’t change the pilot edition of the book during Year 2 because we want reviewers, instructors, and students to have a stable textbook to use this year. The leadership team will make a Year 3 Pressbook reflecting the author team’s Year 2 revisions for use by Early Adoption Instructors next year.

The Lead Author has one month (Year 2, Month 11) to ensure that all documents are ready to include in the packet. Lead Authors can review materials from Year 1, Unit 10 for a reminder about tools and communication guidelines for this process. The table below shows the full packet of documents that each author team will hand off by the end of Year 2.

Figure Y2 6.2 Each textbook has a lot of different parts! We ask that you keep drafting everything in Google Docs so that it is easier to hand off to Revising Authors at the end of Year 2. All of these Google Docs are stored in your author folder for ease of access.
Document Title Purpose Year 2 Actions
Chapter Docs Textbook content Revise for alignment with the project’s criteria for success by taking the four passes described in Year 2, Units 6-9
{Course #} About This Book Defines the original author team’s goals, equity lens, and scope Update outline if needed
{Course #} Prelaunch Front and Back Matter Contains the book sections for students and future instructors that appear before and after the body of the text Revise draft if needed
{Course #} Key Terms Glossary terms and definitions that align with learning objectives for each chapter Keep this spreadsheet updated if you revise key terms or their definitions so that the book’s glossary stays aligned with chapter content
{Course #} H5P Questions Formative assessments that align with learning objectives for each chapter and appear as interactive elements in the Pressbooks platform Keep this document updated as you revise chapters so that the questions stay aligned with the content

Revising Author Role

This might sound counterintuitive, but the original author team might not be the people who make final revisions to the textbook in Year 3. Who will the Revising Author be? As with so many questions about these projects, the answer is “it depends.”

Usually the leadership team will first approach the current lead author and offer them the role. If the lead author is not going to be the Revising Author, our next step is usually to offer it to one of the project’s contributing authors. We also may reach out to people outside the current project team. The approach that the leadership team takes will vary based on the project’s needs. You can read more about the role in the Revising Author unit.

The current author team has invested a ton of hard work and care into the project so far. It can be unsettling to imagine a different author joining the project next year and making changes to that work. Here are a few reasons that the original Lead Author or other members of the current project team may not take the Revising Author role next year:

  • The current author team members may not have capacity to do the Revising Author role next year.
  • The current author team members may decide that the project will benefit from a new perspective.
  • The leadership team may determine that it’s not feasible for members of the current team to align with the project goals in the available time.

In our experience so far, however, the more likely scenario is that the current Lead Author will continue on the project as the Revising Author next year.

One last note: every team should work on their manuscript during Year 2, even if you are 100 percent certain that the Revising Author role on your project will be filled by your current Lead Author. Next year, the Revising Author’s focus will be on implementing the feedback from our external reviewers according to their revision plan – not manuscript development. Year 2 is your time to bring your chapters closer to the goals of the About This Book document.

Keep Going!

It’s reasonable to wonder whether you’re going to spend Year 2 putting effort into things that the Revising Author might end up changing based on the external review feedback. For example, “I shouldn’t write alt text yet because the Revising Author might swap out this figure and that would retroactively waste my time.” This train of thought can lead to putting off a lot of work because everything depends on a future decision that hasn’t been made yet.

Let’s reframe this, staying with the example of writing alt text for your figures. Your media elements may not be fully integrated into your text yet. They should not only have alt text but also be introduced and referenced in the paragraph before they appear, have a caption that shows the connection to the chapter learning objectives, and include a long description if you need to provide more detail for someone who can’t access it visually. Doing this work will help the Revising Author see how the figure aligns with your About This Book goals, and therefore they will see why it should stay in the book. And, since it’s staying, they will also have one less item on their to-do list since you’ve written the alt text already.

You will not be wasting time if you:

  • Focus on tasks that will need to be done regardless of external feedback.
  • Bring your manuscript fully into alignment with the plan you created in your {Course #} About This Book document.

Reintroducing the Open Curriculum Development Project Textbook Criteria for Success

We developed the Open Curriculum Development Project Textbook Criteria for Success to describe concretely what we mean by high-quality course materials. You worked with the criteria extensively in Year 1 of this project, and they are included below as a reminder. You will recognize principles from Transparency in Learning and Teaching, Culturally Responsive Teaching, Universal Design for Learning, and Open Educational Practices that we introduced in the Matrix of Approaches for Equity-Minded Design in Year 2, Unit 1.

Open Curriculum Development Project Textbook Criteria for Success

Our criteria are divided into four categories that, when layered together, make up our definition of high-quality course materials.

Learner focus

  • Chapter is written clearly and uses inclusive language
  • Chapter anticipates learner variability (reading level: grades 8-12)
  • Chapter-level objectives are listed and aligned with the content of the chapter
  • Chapter contains all the parts needed to accomplish the learning objectives
  • Chapter includes multiple forms of media that are relevant to the text
  • Student discussion and reflection questions are clearly identified in call out boxes or predictable places in the chapter
  • Chapter includes at least 3 accessible H5P interactives that are tied to chapter learning objectives
  • Chapter is well organized and reads as a unified text
  • Chapter is consistent in tone, approach, and style

Representation of diverse voices

  • Chapter includes diverse images, voices, viewpoints, or perspectives
  • Chapter lifts up historically minoritized identities
  • Chapter contains up-to-date, relevant, and diverse scholarship and examples
  • Chapter includes accurate citations and attribution statements

Accessibility

  • Images include figure captions and either alt text or long descriptions; do not rely on color to connote meaning; are drafted at high resolution
  • Videos include accurate captions, audio description, and transcripts (including when shared as optional content)
  • Chapter uses consistent headings, in order, that break up the content into a predictable cadence
  • Up to 10 key terms are listed that reinforce chapter concepts, are defined as Glossary Terms, and are aligned with chapter-level objectives
  • Total chapter engagement is scoped to 10,000 words, or no more than 90 minutes of total engagement (approximately 72 minutes of reading time + 18 minutes of required multimedia)
  • All links include descriptive text with the link destination, as well as framing that connects to the learning objectives

Oregon context

  • Copyright restrictions are minimized so that downstream users (your Oregon colleagues) have permission to revise, remix, and share forward
  • Chapter spotlights are relevant and inclusive of diverse Oregon perspectives
  • Chapter spotlights invite Oregon students to connect lived experiences to chapter content
  • Figure captions are clearly connected to chapter learning objectives and include a statement/question inviting Oregon students to make connections with lived experience

Licenses and Attributions for Manuscript Development in Year 2

“Manuscript Development in Year 2” by Open Oregon Educational Resources is licensed under CC BY 4.0.

License

Icon for the Creative Commons Attribution 4.0 International License

Open Curriculum Development Model Copyright © by Amy Hofer and Veronica Vold is licensed under a Creative Commons Attribution 4.0 International License, except where otherwise noted.

Share This Book