A website from the Massachusetts Historical Society; founded 1791.
close

Creation of Digital Edition

General

All content for the Founding Families online editions came from the books as printed rather than from original manuscript sources. As much as it was possible and reasonable, the electronic text retains the information that appears in the books and supplements and extends it only very little. Adams Papers editors approved all necessary changes from the printed pages.

While the digital project sought to maintain the scope and intellectual value of the original publication, it has not attempted to represent the formatting of the printed layout except where that was understood to carry information about the manuscript source. Consequently, page composition elements such as line breaks, stylized characters, and alignment determined by editorial convention are not necessarily replicated in the online display.

Elements that are useful for navigation, such as the page numbers for the original volumes, are embedded in the electronic text and can be accessed. Also, images of printed pages that were especially complex (account books, for example), and are difficult to reproduce electronically, are available for viewing.

Conversion Process

The Founding Families edition has made every effort to use the highest standards for the creation of electronic text and to ensure consistency and accuracy commensurate with the editorial values of the original editions. (To read a full explanation of the practices of the documentary editing project as original set out, please read the introduction to the Diary and Autobiography of John Adams, as published in 1962.)

The initial conversion from either printed pages or PDF of typeset files to XML-encoded ASCII text was performed by codeMantra, a vendor headquartered in Plymouth Meeting, Pennsylvania. The character encoding is UTF-8 unicode. FFP began with a tagset that the staff at Rotunda, the electronic imprint of the University of Virginia Press, adapted from the Text Encoding Initiative (TEI). The current XML files are now fully compliant with the P5 release of the TEI, and we aim to keep those files interoperable with related digital humanities projects. A full list of our tagset as employed, with some explanatory notes, is available by request.

Review of the files as received from the vendor followed two paths: an encoding quality check at the MHS and an external proofreading of the text transcription, paid for by Harvard University Press. The encoding review included extensive development and implementation of guidelines for how to apply the tags in an effort to maintain semantic value and consistency of display.

What Is Different from the Printed Books

The Founding Families digital edition is a document-based resource. While the organizing scheme of volumes is retained in embedded information, we did not rely on the books to determine how the historical writings are made available for your use. Consequently, access points to the online documents make use of information that preceded the books—they are grouped by author, for example, or by date of composition—and any navigation of the contents here will produce results that draw documents from across all of the Adams Papers or Winthrop Papers.

As mentioned above, the digital display does not attempt to replicate the formatting of the printed pages unless that is understood to provide significant information about the original manuscript source.

At the same time, however, the FF edition is not a digital archive and does not pretend to represent the primary sources (for those, please visit the page describing all Adams Family Resources at masshist.org). It maintains information about the manuscripts only where the editors of the print edition felt it necessary to do so. Otherwise, the FF edition seeks to make available all of the meaning and value of the documents as transcribed and described by the editors. Any place where formatting in the print edition indicated editorial significance, a similar or equivalent display convention has been instituted.

Significant Changes from the Printed Editions

Metadata: Printed editions did not require determined metadata such as author and recipient, but these are essential to the user's ability to browse and search the documents in the digital edition. Although the digitization staff has made every effort to assign accurate metadata to the documents, there may still be some misattributions of author, recipient, or date. Please contact us with suggested corrections of you see an error.

Note numbers have been changed in these volumes: DJA03 and DJA04, LJA all volumes, and most PWF volumes. Where an annotation refers to an endnote with a changed number, that new number will appear in the default display.

Errata collected by the Adams Papers editors over time have been instituted in the digital edition as appropriate. Any errors discovered during the encoding process have also been corrected in the electronic text. Users wishing to see the where these variations occur may toggle their view to make this text visible.

Other changes in text: The wording of some editorial text, usually in annotations, has been altered at times to accommodate hyperlinks. Users wishing to see the where these variations occur may toggle their view to make this text visible.

In the digitized text of John Adams Autobiography (last half of DJA03 and all of DJA04), note numbers have been altered and runs of very long text were broken into chunks for online delivery. These abbreviated documents also carry titles supplied by the digitization project.

Conventions Used in the Digital Display

A dateline precedes a salutation at the beginning of Adams Papers letters; this convention is carried over from the books. Similarly, every dateline is flush right and every saluation is flush left. Signatures are also flush right. These conventions do not represent anything about the arrangement of text on the manuscript page. Address lines are not reproduced as part of the historical text in Adams documents but may at times appear in the document description note.

Titles for the family correspondance and the PJA and LJA series are reproduced as provided by the editors; author and recipient information was generally derived from those titles. In the diary volumes (EJA01 and DJA01, 02, first half of 03; DQA01 and 02; all DCA volumes), the title for each document reproduces the date of the entry as written by the author—the same convention used by the AP editors, except that the text appeared in small capitals on the printed page.

[roman]words that were difficult to decipher in the original or that have been conjectured by the editors
[roman?]very uncertain readings
[italics]editorial interjections to explain ms. condition, to clarify ambiguous terms, or to supply missing dates
romanmaterial struck out in the original ms.
||roman||text written in code by the author and decrypted by the editors
        spaces left blank in the ms. by the author
[…]damage to the manuscript that has eliminated text
romantext added or altered for digitization purposes