Proofing Checklists

From ARC Wiki
Jump to navigation Jump to search

Use printouts of these checklists when you proof XML files. When complete, file into the appropriate binder.

RAD Proofing Checklist

RAD Proofing Checklist

File: ____________________________		Wombat: __________________________
Start Date: _______________________		Finish Date: ________________________


__ Open file with Oxygen through “Open URL” (ctrl+U)
__ Place a comment <!-- --> at the top of the file after every editing session.
__ Validate file (ctrl+shift+V) and fix any validation errors.

Compare header (<ram> attribute values and everything within <ramheader>) to a model header for a similar document (e.g. 1-1870.1stedn.rad or 1-1847.morgms.rad).  Check for the absence of typical data: 
	__ <ram> attribute values: archivetype, type, id, metatype, workcode, version, image
	__ <sourcedesc> descriptive data
	__ <title>
	__ <author>
	__ <imprint> or <msprod> data
	__ <provenance>
	__ <physicaldesc>
	__ introductory commentary: <profiledesc>, <commentaries>, <section type=“intro”> 
		__ Spelling
		__ Logic of argument.  (Are the main points clear?  Does the argument rely on presumptions that readers don’t share or does the argument need further evidence?)

Review logical structure of <text>: is their proper nesting and sequencing of ...
	__ <front>, <body>, <back>
	__ <titlepage> and subordinate elements
	__ <div> elements
	__ <p> elements
	__ <lg> and <l> elements
	__ <page> and <epage> elements

Check attribute value for <div>, <p>, <lg> and <l> elements
	__ type
	__ number
	__ indent
	__ image

Transform the file to display in the browser (ctrl+shift+T).
	__ Check the overall visual appearance of the display.
	__ Check the image links and all hyperlinks to see if they work and display properly.
	__ Do all <xrefs> have a corresponding hyperlink?
	__ If not, do such <xrefs> point to files we have in SOURCE?  If so, make corrections.  If not, add link=“dead”.
	__ Carefully compare the image and the rendered transcription.  Fix any errors you find in the tagging, parse, save, and re-transform.
	__ Verify the accuracy of the transcription with a partner.

__ Save the file back over the old copy in SOURCE (ctrl+S, or use the Oxygen icon).  BEWARE!!!  Use of the icon can cause you to save your file over other files.  Use caution!
__ Fill out the check list and file it in the RAD Proofing binder.

*At every stage, be willing to ask questions and discuss any changes you think might be useful for other wombat-proofers to know about.

RAP Proofing Checklist

RAP Proofing Checklist

File: ___________	Title: _________________________________________________  
Wombat: _______	Start Date: __________	     	Finish Date: ____________


___ Before proofing, get latest ram.xsd and stylesheet.
___ Workcode and version correct (check especially for doubleworks).
___ Make sure copyright information is complete.
___ Image id has been entered, unless work is unavailable.  If not, track down image.
___ Image is correct size, right side up, decent quality, color, etc.
notes on image:

Object Descriptions:
	___ Proofread against Surtees entries.
	___ Move any misplaced information to appropriate fields.
	___ Correct model names and notes.  
	___ Standardize watercolour, names, £s, change # to no., etc.
	___ Update provenance and exhibition history when possible (esp. maj. wrks.)

Reproductions:
	___ Check that all have correct citations with working links.
	___ Make sure “no image available” is written when necessary.
	___ Remove superfluous repro details like size and color, after making sure they are in the repro’s rap.

Commentary:	
	___ Move non-object-related commentary to raw and delete from rap.
	___ Proofread for spelling, grammar, etc.
	___ Links functioning.
	___ Make sure sources are cited correctly in text of commentary and are in the bibliography (look especially for uncited transcriptions from Surtees).

Bibliography:
	___ Links functioning.
	___ Bibliography in alphabetical order.
	___ Add link=”dead” to dead bibl. entries (e.g. Benedetti, auction cats, etc.).
	___ Correct citation form (check [[House Style]]).
	___ Change letter citations from Doughty and Wahl to Fredeman.
	___ Add any new entries or xrefs to works cited list.

Browse collection:
	___ All of the images belong together.
	___ Thumbs correspond to titles.
	___ Nothing obvious is missing from group.

___ Comment file and save back over old copy in SOURCE.
___ Fill out checklist in rap binder.

RAW Proofing Checklist

RAW Proofing Checklist

File:  ___________________________	Wombat: ___________________________
Start Date: _______________________	Finish Date: _________________________

Before you proof:  
	* Associate the XML schema with the file "ram.xsd" in /home10/rossetti_work/ROSSETTI/SOURCE
	* Associate the RAW transformation scenario with the stylesheet rossettirawintro.xsl

___ Initial and start-date the RAW in the list in the proofing binder
___ Open file with oXygen.   
___ Place a comment <!-- --> at the top of the file after every editing session.
___ Validate file against the ram.xsd and fix any validation errors.
___ Compare ramheader and all non-content elements to the model RAW (in binder)
___ Transform the RAW with the rossettirawintro.xsl
___ Make sure everything in the XML is correct and, if content, shows up when rendered.

General Description
	___ No empty fields.  If no General Description, alert editor.
	___ Proofread for spelling, grammar, and general accuracy of info, links

Bibliography
	___ Links working
	___ Correct citation form (check [[House Style]])
	___ Where possible, change letter citations from Doughty and Wahl to Fredeman

Scholarly Commentary
	___ No empty fields. If no Printing History, alert editor.
	___ Proofread for spelling, grammar, and general accuracy of info, links
	___ Make sure everything named here appears in the “browse collection” list 

Annotations
	___ proofread, follow and check links. If you make corrections to “annotations,” you can check your correction by transforming the file with rossettirawglosses.xsl.

Make sure each reading text and viewing image link
	___ has the correct thumbnail image, correctly sized
	___ has an appropriate and error-free caption
	___ functions properly
	___ goes to the correct place in the document 
	___ goes to the correct document

Click the “browse collection” tab and make sure each link
	___ functions properly
	___ goes to the correct document
	___ goes to the correct place in the document

___ Comment file and save back over old copy in SOURCE.
___ Fill out the checklist and file it in the RAW proofing binder, and finish-date in binder.    

At every stage, be willing to ask questions and discuss any changes you think might be questionable or useful for other wombat-proofers to know about.