Internal Documentation

PEOPLE

  • SEG: Susan Elizabeth Gagliardi, Project Director
  • CP: Constantine Petridis, Co-Project Director
  • JD: Jen Doty, Research Data Librarian
  • MP: Michael Page, Geographer
  • MS: Megan Slemons, GIS Librarian
  • EH: Erin Hecht, Web Designer
  • XL: Xinyu Liu, Undergraduate Research Assistant
  • LY: Liu Yang, Undergraduate Research Assistant

COPYRIGHT NOTES

  • 2015_10: SEG + CP:
    • SEG + CP agreed addition of images necessary for website legibility
    • CP will generate draft of letter to request copyright permissions
    • SEG will follow up by making inquiries at Emory, revising letter, and returning it to CP for additional review

DATABASE NOTES

  • 2015_10_02: SEG + CP + JD + XL + LY
    • SEG + CP + JD + XL + LY discussed database structure and required rebuilding from a flat database to a relational database with controlled fields for unique record ID and standard museum terminologies for object materials and object types, also individual records need clear identification
  • 2015_10_21: SEG + XL + LY:
    • SEG + XL + LY will compare and contrast Microsoft Access and FileMaker Pro; FileMaker Pro usable on PC and Mac platforms; use of Microsoft Access is more limited
  • 2015_10_22: SEG + JD:
    • SEG determined that Emory’s Samothrace project uses FileMaker Pro and received information that FileMaker Pro works well for the project
  • 2015_10_28: SEG + JD:
    • SEG will check with ECDS to discuss database software the center supports
    • SEG will investigate implications for obtaining software for students
    • SEG + JD established goal to make a decision about what database software to use following the information gathering
    • SEG + XL + LY will continue to work on clarifying definitions and field names as well as determine the fields with controlled vocabularies
    • SEG + CP will work on generating controlled vocabularies based on the controlled vocabularies that the CMA used for Senufo Unbound
    • JD advised use of established controlled vocabularies when possible
  • 2015_10_29: SEG + XL + LY:
    • XL reported that she experimented with FileMaker Pro trial software and found it is more user friendly than Microsoft Access
    • XL will work on a test transfer of data into FileMaker Pro trial software and will identify benefits of transferring the entire database from Excel to FileMaker Pro
    • LY reported that she found open-source database templates
  • 2015_11_05: SEG + CP + JD + MS + EH + XL + LY:
    • JD reported the following information about various database applications:- FileMaker Pro (MCP can help with, installed in 310 lab, Mac friendly)- MySQL (indication from ECDS that supported for Emory use?)- SQLite (ideal for driving websites, but not for collaboration)- Oracle Application Express (cloud-based, reportedly low barrier to use; https://apex.oracle.com/en/)
    • JD supplied DataONE Data Entry + Manipulation handout clarifying best practices for data entry
    • SEG + XL + LY will review existing Excel database to differentiate between fields / columns with essential data to display on website and fields created to disambiguate between objects
    • SEG + XL + LY will clarify definitions
    • SEG + CP will work on creating controlled vocabularies for certain fields after SEG + XL + LY establish fields for revised site
  • 2015_11_06: SEG @ ECDS
    • SEG will contact Sara Palmer of ECDS to discuss Omeka versus WordPress as well as possibilities for linking databases to Omeka and WordPress site
  • 2015_11_12: SEG + XL + LY :
    • SEG + XL + LY created bare-bone spreadsheet to import into CartoDB;  XL will work on revising field names
  • 2015_11_18: SEG + XL + LY:

MAPPING NOTES

  • 2015_10_02: SEG + CP + MS + XL + LY:
    • SEG + CP + MS + XL + LY examined limitations of web-based map and its functions (e.g., green bubbles on map difficult to understand; easy to zoom into map and become disoriented geographically; information in pop-up windows confusing)
    • XL + YS will continue to work in consultation with MS to produce geo-referenced historical maps (Binger, Frobenius, and Delafosse) and essays describing the maps for eventual publication on Mapping Senufo site
  • 2015_10_21: SEG + MS:
    • SEG + MS reviewed maps and objects on Omeka sites including Cleveland Historical and the Story of the Beautiful for ideas about how to revise Mapping Senufo
    • SEG + MS looked briefly at CartoDB
    • MS will investigate other possibilities for resolving difficulties with the web-based maps
  • 2015_10_29: SEG + XL + LY:
    • XL + LY will begin translating notes on their geo-referenced historical maps into drafts for publication with an initial statement describing the goal, a description of the historical map and its specific features, a clear and detailed account of steps taken to geo-reference the map, a clear and detailed description of outcomes including challenges in the geo-referencing process, and a summary of future consideration
  • 2015_11_05: SEG + CP + JD + MS + EH + XL + LY:
    • SEG + CP + JD + MS + EH + XL + LY w/ input from MP determined that CartoDB might work better for the WordPress site than Maps Marker Pro; possible advantages seem to include: ability to import shapefile as a single layer, greater icon selection and more possibilities for developing custom icons, more possibilities for creating an interactive map with up to four layers (including any shapefiles imported as layers), possibilities for creating pop-up windows with images and a few bits of text, and possibilities for linking a csv file to the map in order to eliminate redundancy in creation of website; possible disadvantages seem to include: limited to no possibilities for original cartography, number of layers in any one map limited to four
    • SEG + XL + LY will prepare database and shapefile to share with MS; MS will draft map in CartoDB for incorporation into revised website
    • SEG + CP will discuss what layers might make sense to show on a single map
  • 2015_11_12: SEG + XL + LY :
    • SEG created created a draft map in CartoDB

WEB-DESIGN NOTES

  • 2015_10_04: SEG + CP:
    • SEG + CP discussed limitations of web-based map and its functions (e.g., green bubbles on map difficult to understand; easy to zoom into map and become disoriented geographically; information in pop-up windows confusing; slowness of site frustrating)
  • 2015_10_13: SEG
    • SEG received similar feedback from an outside viewer knowledgeable about digital projects; person identified similar limitations (e.g., green bubbles on map difficult to understand; easy to zoom into map and become disoriented geographically; lack of images of actual objects and field documentation frustrating)
  • 2015_11_05: SEG + CP + JD + MS + EH + XL + LY:
    • MS will share CartoDB map with EH for incorporation into revamped website
    • EH will create a revamped website that (1) maximizes the map on the homepage, highlighting it instead of the images (for example, see the map on the Cleveland Historical homepage), (2) minimizes images on the homepage and elsewhere on the map (again, see the Cleveland Historical homepage), (3) reduces the amount of text in pop-up windows (again, see the pop-ups on the map on the Cleveland Historical homepage), (4) uses tabs to distinguish among different kinds of information about individual objects (for example, see single object entry on the Story of the Beautiful site), (5) uses tabs to distinguish among different kinds of notes on the Internal Documentation page
    • SEG + CP will work on clarifying different kinds of information for individual objects, using single object entries on the Story of the Beautiful site as models
    • SEG + CP will continue to work on writing essays for publication with individual object entries on the site
  • 2015_11_12: SEG + XL + LY :
    • XL + LY will work on organizing internal document page layout.

 

COMPARATIVE SITES

COPYRIGHT AND DATA REFERENCE POINTS

OTHER DIGITAL RESOURCES

HOW-TOs