end/line: week 3

During the last class, we have been asked to focus on our data management plan, another fundamental step for the development of our digital project. Indeed, end/line is an app where users can upload poems in plain text, encode them following TEI Guidelines and finally compare their own encoding with other users. So, we will deal with plain text, TEI XML, and user information data, connected with what we directly produce through our Commons blog and our Twitter account.

Instead, on the community management side – which is my direct field of competence – I am starting to build a group of testers who will test end/line and give us back their feedbacks. Last week, I wrote a post on our Commons blog explaining the approach to TEI we want to develop, offering our users the possibility to directly experience TEI by encoding. Both the post and my research for testers rely on the community of TEI people, and this is an extraordinary resource. TEI is indeed a consortium of people aiming to maintain a standard for the representation of texts in digital forms, and everybody is concerned about it: sunscribing to TEI listserv is a proof of the commitment of people, who propose changes in the code or in the attributes of TEI, ask help to other users about problems or difficulties they encountered, and propose collaboration to projects. For this reason, and after having asked Tom if this could be a good idea, I launched a call for participation in our testing through TEI Listserv.

So far, the call reached a certain success: I received emails from people all around the world (Wisconsin, Madrid, Berlin, Oxford), interested to become end/line testers. I will probably send a reminder through TEI listserv during next week, to increase our testers.

Biographical information:

Iuri Moscardi, born in Italy, is now a PhD student in Comparative Literature (Italian specialization) at CUNY Graduate Center: his research is focused on contemporary Italian literature and Digital Humanities. He is a member of the end/line development team, where he serve as Community Manager in maintaining contacts with the wider TEI community.

Posted in Diary, spring17, Student Post | Comments closed

end/line — DMP, ERD, and Me

Data management is extremely important on the back-end side of a project, which is where I’m situated right now. Honestly, data management is most of what I need to do. The most important aspect of it (and will eventually affect how the data is sent to and from the front-end) is how the data tables will be laid out. To achieve this, I’ve begun work on something called an entity-relationship diagram. Some of you might recall that I wrote a blog post about them last semester. They are a way to lay out exactly what the tables will be, what attributes they will have, and how they connect to each other. For the data management plan, we need to know that our database is workable.

I went about making a very rough diagram and came out with four distinct tables. The first will be for users and their login info, the second will be for users and their profile info (email, name, etc…), the third will be for XML posts (date posted, text of it, author and name of poem), and the last is for connecting the user table to the posts table. Of course, this is still subject to change based on how the project will morph over the coming weeks and months. There might be tables we don’t even know we need right now.

For the database itself, we’ve decided to go with cloud storage and use a free database like PostgreSQL or MongoDB. This will then be connected to our web app on the back-end. It’s important for any data management plan to know where this data will be stored and have a trusted database technology behind it. PostgreSQL and MongoDB are scalable and can be used easily at the start and can continue to function well beyond the early scope of this project. These are also up-to-date and modern, and are used throughout the field of data management. There’s very little concern that they will be deprecated any time soon. Using these should help to show that we have an understanding of the potential longevity of the project.

To sum everything up, my research into what technologies to use and how to use them are going to be affected by the data management plan. What we’re storing and how the app will work will determine how I go about building the database in the end.

Posted in Diary | Comments closed

end/line: week 2

During our last class meeting, we started to discuss about data management, trying to define which kind of datas we need to build our project and, also, sketching a first graphical, “concrete” draft of it by pen and paper.

My duties are related to the Community Management of the project, especially considering the TEI Community. So, during this last week I was focused especially on the TEI Guidelines.

First of all, I have written and published a post, as required by the team, to describe how end/line will relate to the more general environment of TEI Community. Michael was in charge to open, thanks to professor Rhody, a new space for blogging on Commons: this is the end/line project blog, to be read and consulted to keep track of our progress towards the completion of it. In the post, I tied end/line purposes (and especially the different approach to the employment of TEI Guidelines) to the TEI Community, emphasizing both similarities and differences between ours and projects developed by other universities, research centers, or scholars.

I have also started to deal directly with TEI Guidelines, in order to acquire the expertise required to the construction of end/line. I have subscribed to TEI Listserv, receiving e-mails with a lot of different informations; I have started to think about a group of beta testers for end/line (and considering the TEI Listserv a possible way to recruit them); I have downloaded Oxygen XML and started to practice with my encoding; I have finally look for some tutorials online about TEI Guidelines.

Posted in Diary, spring17, Student Post | Comments closed

Weekly Blog Post 2 – DMPs and Me

After reading a bit more into data management plans, it’s very clear how useful they are not just for large scale projects, but for my own research practices for a couple of reasons.

Outlining what data you believe you’re going to collect for a project is not just helpful for record-keeping, but also determining the scope of the project. Expected data deals with what you believe the project or research is going to capture throughout its duration. It’s not just a number – an outline of expected data includes file types and original locations. Not outlining what kind of data you’re expecting to aggregate could be detrimental to your operations due to unexpected size, storing, and backup issues. It’s also important to have a grasp on what kinds of file formats you’re going to be dealing with. There’s not just data to worry about but metadata as well that has to be accounted for when dealing with any of this data (in terms of transfer or context).

Hard drives and cloud storage can eventually fill up and become quite costly. Data types for a project or research might slowly grow in size over time, and it’s important to have a schedule of what to keep. On a personal level, not knowing how long you’re going to retain data is dangerous because you can be blindsided by storage issues if you cannot handle the lifecycle of a project or research endeavor. Related to this is data security – with the amount of data that’s being processed and stored, there’s a large risk for partial or total loss. There might also be sensitive materials that need to be stored but kept classified. Having a plan for all this mitigates risks that might come from any research project including these types of data.

On a more blunt note, DMPs will always be useful for personal research practices because they’re required for grants. If your DMP isn’t strong, or there’s information that’s missing, you’re less likely to get approved for funding.

Posted in Diary | Comments closed

Sustainable (and Political?) Research Practices

While data management plans might seem like pro forma requirements for digital humanities grants, they also encourage scholars to chronicle the details of and the infrastructures that support their projects. For example, a grant application to digitize a mural in New Mexico mentions that “hundreds of digital images will be stitched together to create a composite panoramic image” for display on a website, which seems clear enough (HD-51506-12). Yet this same data management plan also mentions that the original images will be high-resolution Canon Raw files that the team will upload via SFTP (secure file transfer protocol) to a server at the University of New Mexico (HD-51506-12). Thinking through my own work, at this level of detail, would certainly force me to acknowledge the apparatuses—the libraries, information technology departments, and even public utilities—that support it. It would also force me to think about the sustainability of my work far in advance of its completion. How others might access my work, not only upon its completion but years in the future, would no longer be an afterthought. Instead, it would become central to the production of scholarship itself.

An increased attention to the details, infrastructures, and sustainability of research, in turn, has contemporary political import. For example, a recent New York Times article describes a growing sense of unease, among scientists and academics, about access to and preservation of important government databases: “‘At the moment, more people than ever are aware of the risk of relying solely on the government to preserve its own information,’ two government document librarians … wrote” (Harmon). Given the current administration’s indifference to scientific data, and given the fragmented access and preservation practices of government agencies, data management plans make sense. They provide scholars with a framework to log the technical details of their projects, understand how a host of institutions can support them, and consider how to sustain them after their initial releases.

Works Cited

Harmon, Amy. “Activists Rush to Save Government Science Data — If They Can Find It.” New York Times, 6 March 2017, https://www.nytimes.com/2017/03/06/science/donald-trump-data-rescue-science.html.

HD-51506-12. “Digital Dialectic: Forging New Paths of Inquiry in the Humanities,” https://www.neh.gov/files/dmp_from_successful_grants.zip.

Posted in Diary, spring17 | Comments closed

ZUC

For this week’s collective blog post, our team started to gather information regarding general guidelines for Data Management Plans. In order to do so, we looked into our own revised workplan and also into the Data Management research guides from the Graduate Center Library.

Step 1. Key Summary of the ZUC Project

(This information was already thoroughly detailed in Jenna’s project proposal.)

   A cross­-repository resource for zine research, providing access to metadata about as many zines, and in as many ways (linked open data, links to digital content, etc.) as possible.

   A collaborative platform for cataloging zines and their creators, by persons both within and external to the library profession.

   A hub for zine research, where partners can seek inspiration and collaboration.

   A promotional and educational resource for the zine genre.

   A tool capable of supporting projects to incorporate digitized (and born digital) zine (and zine­ related) material into other platforms such as the Digital Public Library of America (DPLA).

Step 2. Kinds of Data

For the purposes of this project, our team will not be producing new data. Instead, we will work with metadata—data or content that describes the information about the zines—already created and publicly shared on the xZINECOREx GitHub repository.

Regarding the data that will appear on the web-based application, our goal is to begin importing and managing one of the metadata sets that are included in the repository—including the Denver Zine Library Catalog, Barnard College, Carnegie Library of Pittsburgh, Queer Zine Archive Project (QZAP), and ABC No Rio, among others. Our team—and, more specifically, the Lead Developer—will be responsible for controlling the data after we build up a working environment for the webserver.

Given the collaborative approach of the project, not only within our team, but also when it comes to other cultural institutions and enthusiasts, we are contemplating on retaining the data for as long as possible—maybe permanently?

Step 3. Identification of the Standards

To set up the back-end of the webserver we will be using Collective Access, an open-source collections management software specifically designed for projects like ours. The metadata standard required, in this case, is xZINECOREx, created for the QZAP Collective Access profile. As we already mentioned in our ZUC Revised Workplan, xZINECOREx is a refined schema of the Dublin Core standard that addresses issues that apply to zines in particular. Moreover, xZINECOREx is able to unify the metadata into the same standard in order to share the same bits of information about zines.

On a separate note, the team is obtaining valuable information regarding the front-end, browsing mechanisms, and subject thesauri from other Collective Access projects including LaMaMa, the New Museum, the Interface Archive, QZAP, OCLC WorldCat, CLIO, Sallie Bingham Center zine catalog, Open Library, and Project Gutenberg, for example.

Posted in spring17, ZUC | Comments closed

Delving into the Details: Data Types, Project Resources, and Wireframes for end/line

After organizing into teams and assigning roles and responsibilities to team members, we’ve certainly entered the “praxis” phase of this course. While the proposal process dealt mostly in generalities, the past week has forced us to transform some of our vague ideas into actionable tasks by cataloging data types, clarifying project resources, and wireframing important prototype components.

Data Types

We began last Wednesday’s class by itemizing all potential data types for end/line in a shared Google document. As Lisa suggested we moved from the front- to the back-end and then turned our attention to some of the supplemental material that will support the project.

Two forms will drive much of the user experience on end/line: one form to submit a poem, another form to encode it. The first form will need to record usernames, titles, authors, and the actual poems. It will also need to associate first and last names and email addresses with usernames and assign each entry a unique identifier and timestamp. While the second form will also need to record usernames (and associate and assign the same metadata), it will record and validate XML encodings of poems. We’ll manage both forms through a front-end framework—either Angular or Node. Meanwhile, we’ll then need to log all of this information in a back-end database—either Postgres or Mongo. This setup will obviate the need for a CMS to manage “About,” “FAQ,” “Terms of Service,” “Privacy Policy,” and other static pages. We’ve also planned to host our code, under an MIT license, in a public GitHub repository.

The community management team will oversee some of the supplemental data types, like our Commons blog and Twitter account. And the project manager will ensure the archival of our collaborative Trello and Google Drive work.

Project Resources

Because we all expect to learn new, necessary skills during this project, we’ve made sure to clarify either from whom or where to find help. For example, our “Project Roles and Agreements” document clarifies that Brian may consult on front-end development, Greg on project management, and Tom on community management, while Iuri explains the intricacies of TEI and Michael leads some of the course-specific deliverables. Furthermore, we’ve agreed to post all general questions, tips, and suggestions in Slack, and Tom has shared the credentials for Safari Books Online—a subscription library for developers, project managers, and other technology professionals—with the team. We’ll also avail ourselves of Graduate Center and other workshops as needed.

Wireframing

By the end of Wednesday’s class, we began wireframing some key pages and forms—including the homepage, search flow, submission and encoding forms, and comparison views—on pen and paper. Greg transferred these sketches onto Adobe XD later in the week, and they will help guide much of the front-end development work and help the community management team explain the project’s potential to early users and the wider public.

Posted in spring17 | Comments closed

End/Line Week 1 Reflection

On the project, I have one main role and two assistant roles. My main role is being the frontend developer. The tasks that are included with this role are working within a framework, compiling a wireframe for review with my group, and major debugging. I have some experience with HTML/CSS and development concepts, but I’m probably going to have to work closely with Brian not just for his role as the backend developer, but also for his knowledge of frontend development.

My other two roles are assisting Brian with backend development when needed and assisting Tom with project management. I have a background in management at the media company that I work for so I feel I can make meaningful contributions on that end as well.

On the project management side of things, my first thoughts immediately went to free tools that can help us not only keep track of tasks, but also communicate effectively. During our first session, we set up our communications on Slack, and our task management on Trello. We are also using Google drive for some asset storage and backups (thankfully I have a large plan so I’m not worried about the hosting on this end).

I recently built out Tom’s revised work plan on Trello, but now it’s definitely time for me to take a backseat on project management and switch to my main role.

Because I have some familiarity with databases, my first order of business is to learn Express, Node.js, and some JavaScript. Also, I have to really learn up on XML and the TEI’s standards associated with encoding actual works. It’s going to be a very rough road, but I am more than confident in my abilities to cram it all for this project. There are plenty of guides online for setting up and working within the framework and server-side language, so I’m not too worried.

Coming from a background in just simple HTML/CSS/WordPress editing, I feel that I’m going to get a lot out of this considering how different of an undertaking this is. I’m also excited to be a participant in a project of this caliber as well. It will be exciting to finally finish this tool and be able to present it, and I know that I’ll take what I learn in the process and apply it to future projects.

Posted in spring17, Student Post | Comments closed

Pulling It Together

After the rush of last week, I’ve started to focus on the details of end/line (the new, group-approved name for the “encoding as close reading” project). I’ll be serving as project director and project manager, articulating its overall vision and ensuring that our group of five keeps it on track. Obviously, the need to communicate its goal of providing a platform for a particular mode of poetry/poetics and digital humanities pedagogy will prove challenging, as will the quick turnaround required for this project. Though I’ve never directed a project before, I hope to attend the 13 March GCDI workshop on digital project implementation. And while I do have some professional experience managing web development projects, I’ve only done so in existing infrastructures where, for example, third-party vendors handled all hosting or database tasks and details or we hired a professional designer to produce the marketing material. With end/line, I’ll need to think all of those tasks that I’ve previously taken for granted. I’d also like to hone my existing project management skills, and have started reading a host of articles on the subject at A List Apart.

Despite these challenges, however, I’m excited about the prospects for end/line for numerous reasons. First, the Textual Coding Initiative is a longstanding digital humanities community (dating back to the 1980s) and, by interacting with its verse module, even in this small way, I think we can articulate its ongoing importance to the field (and to literary studies in particular). Second, my work at the Graduate Center has drawn me, increasingly, to twentieth- and twenty-first-century experimental poetry that might frustrate encoders and challenge close readers. When the class workshopped my initial proposal, Eddie mentioned Susan Howe as an example of someone whose work would be difficult to encode. I’d love for our final prototype to demonstrate, technically and visually, how encodings are themselves acts of reading that produce interpretations. Third, as Professor Brier often explained last semester, much digital humanities work ignores pedagogy; this project does not. And, finally, translating last semester’s thoughts, ideas, and curiosities into an application like this seems like a worthwhile goal.

Posted in Diary | Comments closed

ZUC Personal Journal

My role in the ZUC project will be as project manager. Even though Jenna is in charge of supervising the steps we will take along the way, I will try my best to keep everything—and everyone—on track in order to meet the deadlines and accomplish our weekly goals.

On the one hand, this is definitely a challenging task for me. Unfortunately, I have rarely participated in group projects such as this one in the past—that is one of the main reasons why I thought about being the project manager in the first place. On the other hand, this is an exciting opportunity to contribute to the creation of a cross-repository catalog that will definitely be useful to a wide audience of both zine specialists and zine culture lovers. I am glad to be part of this team of individuals whom, from day one, are committed to build up this platform.

During these first few days, we decided that we would try to gather as much information as possible regarding ZUC and library cataloguing standards terminology—including Collective Access and xZINECOREx. We also agreed that Lauren would be in charge of deciding what the best alternative is when it comes to team/project management software. I assume that, given my role as project manager, I will take on the task of updating the calendar, the relevant notes, and the deadlines to meet through the tool we end up choosing to communicate with each other individually and as a group.

In her initial project proposal, Jenna also mentioned the need for a lead designer. When the time comes and we have a working environment set-up and a back-end built for the catalog, I will be happy to contribute to that role as well. I have some experience in graphic design—at least in the field of publishing—so I will try to learn as much as possible about Collective Access and help with the design and visual aspects of the front-end of the site.

Everyone seems to be very passionate about the project. I hope we can all keep working hard and, when the time comes, are able to deliver what Jenna envisioned when she wrote her proposal.

Posted in Diary, ZUC | Comments closed
  • Archives

  • Welcome to Digital Praxis 2016-2017

    Encouraging students think about the impact advancements in digital technology have on the future of scholarship from the moment they enter the Graduate Center, the Digital Praxis Seminar is a year-long sequence of two three-credit courses that familiarize students with a variety of digital tools and methods through lectures offered by high-profile scholars and technologists, hands-on workshops, and collaborative projects. Students enrolled in the two-course sequence will complete their first year at the GC having been introduced to a broad range of ways to critically evaluate and incorporate digital technologies in their academic research and teaching. In addition, they will have explored a particular area of digital scholarship and/or pedagogy of interest to them, produced a digital project in collaboration with fellow students, and established a digital portfolio that can be used to display their work. The two connected three-credit courses will be offered during the Fall and Spring semesters as MALS classes for master’s students and Interdisciplinary Studies courses for doctoral students.

    The syllabus for the course can be found at cuny.is/dps17.

  • Categories

Skip to toolbar