• Skip to main content
  • Skip to secondary menu
  • Skip to primary sidebar

FromThePage Blog

Crowdsourcing, transcription and indexing for libraries and archives

  • Home
  • Interviews
  • crowdsourcing
  • how-to
  • Back to FromThePage
  • Collections

Writing Transcription Conventions & the Project Help Page

FromThePage provides two configurable documentation areas per project.   "Transcription Conventions" are displayed on the transcription page under the text input field.   The "Help" is displayed as a tab in each work and on each page.  Transcription conventions are intended to be short, with enough information to get a transcriber started.  FromThePage automatically provides a "more help..." link at the bottom of the transcription conventions that links to the help tab.  Both pages have short default instructions provided, but you will likely want to customize them for your project.

Transcription Conventions

Here's what you should cover in your transcription conventions:

  • Line breaks and paragraph breaks.
    Line Breaks:Hit enter once after each line ends. Two enters indicate a new paragraph. The times at the end of each entry should get their own paragraph, since the software does not support indentation in the transcriptions.
  • What to do with spelling?  Most projects instruct transcribers to keep the spelling as it's written on the page.  Examples:
    Spelling:Use original spelling if possible.
    Spelling: Transcribe people's names exactly as they appear, including typos and abbreviations: Thpmas or Wm. For town and city names, however, type the correct name: Marengo instead of Maringo
  • What to do with illegible text?
    Illegible text: If characters in a word are difficult to read, make a guess and enclose the entire word in single square brackets: [Tomlinson]
  • How & when to use the "needs review" checkbox.
  • If you have text in a language with characters that most of your transcribers' keyboards won't support, providing those characters in the transcription conventions with instructions that your transcribers can copy and paste them.
  • Link to your examples document, and comment on the choices you made in the comments.
    Examples: Refer to <a href="http:// ">these examples</a> for samples of transcriptions. See the Page Notes at the bottom of each page for explanations and tips.
  • Are you using the subject linking  (also known as  indexing or annotating) feature of FromThePage?
    "Autolink" will suggest subjects certain words could be linked to or you can use double braces to link subjects. [[Jane Doe]] will link the text "Jane Doe" to the subject Jane Doe, while [[Jane Doe|Jane]] will link the text "Jane" to the subject Jane Doe. We recommend that linking be left to an editor after the initial transcription is made.

The advanced mark-up article provides examples and instructions for special cases and more advanced transcription techniques.  You should review those cases and pull the appropriate instructions into your project's documentation.

Project Help Page

Here's what you should put in your Project Help Page:

  • Collection information & the purpose of the transcription project.  How is the transcription going to be used?
  • Types of material.  If you have multiple categories or types of material in the collection, include a quick overview of each kind.
  • Repeat and expand on your transcription conventions.  Consider including examples.
  • Some FromThePage help -- how to find a page to transcribe, how to work with the transcription images (zoom, changing the layout of the transcription page), how to save, when to use the notes area, etc.  You might want to include a link to our demo video:  https://www.youtube.com/watch?v=cO2j1Xuasbc
  • A contact email for questions.
  • Link to your examples.

The Alabama Department of Archives and History published their help both in their project and as a downloadable pdf.  It's a good example to refer to.

Examples

Yaquina Lights Transcription Conventions:

Los Angeles County Transcription Conventions:

Alabama Department of Archives and History Transcription Conventions:

 

Wisconsin Historical Society Help Page:

Wisconsin Help

Suggestions

  • We recommend you create an "examples" work.  I think the easiest way to do this is to download each of the pages, zip them up as Examples.zip, and then upload them in the "Start a Project" screen.
  • Working through your examples is a great way to build your transcription conventions and help.  Use the "comments" at the bottom of each page to note why you made certain decisions.
  • While we think transcription conventions should be short -- 20 lines at the most -- it's possible to do more than 20 lines.   Here's an example with a lot of html based formatting:  https://fromthepage.com/jbhoward/irish-dialect-archive-manuscript-collection/seanchas-cuimhni-cinn-by-sean-o-dalaigh/transcribe/20905  We'll reiterate that we think shorter is better "on the page" and longer content belongs in the help tab.
  • Don't be afraid to update your transcription conventions or help pages often.  If one volunteer asks a question it is likely that another one will have the same question.

We're happy to review both your help and transcription conventions, and help if you run into any formatting issues with them.  Just email support@fromthepage.com.

Save

Save

Save

Save

Primary Sidebar

What’s Trending on The FromThePage Blog

  • Guide to Digitizing Your Archives
  • How to Handle Racial or Ethnic Slurs &…
  • An Interview with Keith Mitchell of The National…
  • An Interview with Jodi Hoover of Digital Maryland
  • Project Profile: Stanford University Archives
  • Privacy And Copyright Considerations Using GPT Models

Recent Client Interviews

An Interview with Candice Cloud of Stephen F. Austin State University

An Interview with Shanna Raines of the Greenville County Library System

An Interview with Jodi Hoover of Digital Maryland

An Interview with Michael Lapides of the New Bedford Whaling Museum

An Interview with NC State University Libraries

Read More

ai artificial intelligence crowdsourcing features fromthepage projects handwriting history iiif indexing Indianapolis Indianapolis Children's Museum interview Jennifer Noffze machine learning metadata ocr paleography podcast racism Ryan White spreadsheet transcription transcription transcription software

Copyright © 2025 · Magazine Pro on Genesis Framework · WordPress · Log in