Skip to content
ADVERTISEMENT
Sign In
  • Sections
    • News
    • Advice
    • The Review
  • Topics
    • Data
    • Diversity, Equity, & Inclusion
    • Finance & Operations
    • International
    • Leadership & Governance
    • Teaching & Learning
    • Scholarship & Research
    • Student Success
    • Technology
    • Transitions
    • The Workplace
  • Magazine
    • Current Issue
    • Special Issues
    • Podcast: College Matters from The Chronicle
  • Newsletters
  • Events
    • Virtual Events
    • Chronicle On-The-Road
    • Professional Development
  • Ask Chron
  • Store
    • Featured Products
    • Reports
    • Data
    • Collections
    • Back Issues
  • Jobs
    • Find a Job
    • Post a Job
    • Professional Development
    • Career Resources
    • Virtual Career Fair
  • More
  • Sections
    • News
    • Advice
    • The Review
  • Topics
    • Data
    • Diversity, Equity, & Inclusion
    • Finance & Operations
    • International
    • Leadership & Governance
    • Teaching & Learning
    • Scholarship & Research
    • Student Success
    • Technology
    • Transitions
    • The Workplace
  • Magazine
    • Current Issue
    • Special Issues
    • Podcast: College Matters from The Chronicle
  • Newsletters
  • Events
    • Virtual Events
    • Chronicle On-The-Road
    • Professional Development
  • Ask Chron
  • Store
    • Featured Products
    • Reports
    • Data
    • Collections
    • Back Issues
  • Jobs
    • Find a Job
    • Post a Job
    • Professional Development
    • Career Resources
    • Virtual Career Fair
    Upcoming Events:
    College Advising
    Serving Higher Ed
    Chronicle Festival 2025
Sign In
Profhacker Logo

ProfHacker

Teaching, tech, and productivity.

Getting Started With a GitHub Repository

By Konrad M. Lawson March 15, 2013
skitchtocat

If we look across the landscape of collaborative writing on the web, there are a few clearly discernible hubs of activity. Wikipedia and Google Docs might be identified as two of them, but one the most remarkable and unique is

To continue reading for FREE, please sign in.

Sign In

Or subscribe now to read with unlimited access for as low as $10/month.

Don’t have an account? Sign up now.

A free account provides you access to a limited number of free articles each month, plus newsletters, job postings, salary data, and exclusive store discounts.

Sign Up

skitchtocat

If we look across the landscape of collaborative writing on the web, there are a few clearly discernible hubs of activity. Wikipedia and Google Docs might be identified as two of them, but one the most remarkable and unique is GitHub. This is the first of a new series of postings on GitHub, its limits, and some emerging alternatives for scholarship. GitHub is the leading hosting service for code that runs the powerful distributed version control software git (see Julie’s introduction for more on version control). While many outside the world of programming may never have heard of it, I think it is important to recognize it as a site of online writing and creativity as important as any other of our time. The phenomenal rise of GitHub in the world of coding has been described in the Wired feature, “Lord of the Files” and the authors even wrote the article itself in a GitHub repository. It is my conviction that some of the most important innovations that stand behind its rise will come to have a profound impact on writing and sharing in the humanities as well.

Perhaps the most important feature of GitHub that has made it such an attractive home to open source and, increasingly, text documents, is the way in which it enables a form of “collaboration without collaboration.” On this platform of millions of repositories of (mostly) text it is incredibly easy to not just download other people’s work, but “fork” it, modify it, and either propose that your modifications be “pulled” back into the original or else continue to live independently. This all happens while maintaining a full history of who changed what line of information and preserving a connection is preserved back to the original project it may have originated from. On platforms like GitHub (it is neither the first nor alone, but has a strong lead today), complete strangers can communicate through “commit messages,” that describe the changes they made without forming teams or joining a project (though teams and projects might develop out of these initial contacts). In this way, authors don’t operate on a single canonical document (as in Wikipedia or, most often Google Docs / Etherpad documents) but keep their own copy that can either merge or diverge from the founding text. They also operate in a world where contributions, in the form of commits, are all recorded, allowing a rich ecology of attributions that is already a powerful currency of legitimation in the programmer community.

ProfHacker on GitHub

GitHub has already made several appearances here at ProfHacker. Brian introduced the idea of posting and forking syllabi, and Lincoln wrote about how one actually goes about forking a syllabus you might find on GitHub as well as some tips on good basic practices. Mark put his syllabus for a course on Video Game Studies on GitHub but then asked some really important questions about the value and best practices of creating repositories out of our syllabi.

In this posting I want to simply introduce how one might get started with their own GitHub repository for any kind of text, whether it is a syllabus for a course, an article you wish to open to collaborative authorship, or any other text you want to expose to the powerful versioning features of git - all without using the command line. As we have mentioned in some of our earlier postings on GitHub, the best way to compose documents that you want to share on GitHub is in plain text, perhaps with Markdown or some other formatting so you can easily export later to other outputs such as PDF, HTML, and so on. Images, and other binary files can also be included in Github, but they are best limited to supplementary files.

1. Create a GitHub account

If you don’t already have an account, you will be able to create one easily just by going to the GitHub homepage here. GitHub accounts are free, and remain so as long as you allow your repositories be open source and available to the world. You only have to get a paid account if you wish to have private repositories protected from prying eyes.

2. Download the GitHub client

GitHub has client software that allows you to interact with your account and perform the most common tasks. It won’t be enough for the more powerful advanced features that a version control system like git allows, but serves nicely for most things. Lincoln and Mark and have introduced the Mac (Download) and the Windows (Download) client here at ProfHacker last year. Download the client and install it on your computer. In the examples below I’ll use the Mac version, but most steps should be almost the same for Windows.

3. Create a repository within the client

The first time you run the client on your computer, you will be asked to provide your name, email address, and sign in to your GitHub account. After you do this, you can begin to use the client as a way to manage your local repositories, download repositories you may have forked, and push changes that you make to the GitHub servers.

New Repository
“Create New Repository”

To add a new repository choose “Create New Repository” from the "+" menu at the bottom of the screen (in the Mac client. The Windows client may be a little different). Choose a name and a location on your computer to keep your repository files. Think of your repository as a single writing project, whether it be a simple syllabi to more complex articles, dissertations, and so on.

4. Publish the repository to your account

When you added a new repository, all you get is what looks like a blank folder on your hard drive. If fact, there is also a hidden directory inside your new repository called ".git” which stores everything about your files and their history.

Add a plain text file in your new repository folder using whatever text editing application you like working with best. When you return to the GitHub application, you will see (on a Mac at least) that the second icon “Changes” will have changed slightly to indicate that your repository has new changes.

Commit Changes

Here it is important to understand that getting your changes to GitHub is a two step process. First you “commit” your changes, which will record a “commit message” giving you an opportunity to describe what kind of changes or additions you have made. Enter your commit comment, and an optional elaboration and note that the new plain text file you put in the folder is selected by default. Press “Commit.”

Now the final step of pushing your commit to the server can happen. Since you have just created a brand new repository, the “Sync Branch” button at the top right should say instead, “Publish Branch.” Click on this button and you are done. If you open your GitHub account online you should see your repository and the file that you added.

This series on GitHub will continue next week with a post on direct editing and zen writing mode, on forking and pull requests, a discussion of some good online sources for learning more, a post on the limitations of GitHub from the perspective of writers outside the world of code, and then an introduction to Authorea, the first git-based platform that really tries to meet some of these challenges, especially for the world of collaborative publishing for scientists.

Share some of your favorite GitHub based syllabi, articles, government and archival text repositories in the comments. Also, what are some of the features, issues and challenges you would like to have addressed in the upcoming postings of this series?

Image “Skitchtocat” in the Octodex collection by GitHub under terms here.

We welcome your thoughts and questions about this article. Please email the editors or submit a letter for publication.
Share
  • Twitter
  • LinkedIn
  • Facebook
  • Email
ADVERTISEMENT
ADVERTISEMENT

More News

Vector illustration of large open scissors  with several workers in seats dangling by white lines
Iced Out
Duke Administrators Accused of Bypassing Shared-Governance Process in Offering Buyouts
Illustration showing money being funnelled into the top of a microscope.
'A New Era'
Higher-Ed Associations Pitch an Alternative to Trump’s Cap on Research Funding
Illustration showing classical columns of various heights, each turning into a stack of coins
Endowment funds
The Nation’s Wealthiest Small Colleges Just Won a Big Tax Exemption
WASHINGTON, DISTICT OF COLUMBIA, UNITED STATES - 2025/04/14: A Pro-Palestinian demonstrator holding a sign with Release Mahmud Khalil written on it, stands in front of the ICE building while joining in a protest. Pro-Palestinian demonstrators rally in front of the ICE building, demanding freedom for Mahmoud Khalil and all those targeted for speaking out against genocide in Palestine. Protesters demand an end to U.S. complicity and solidarity with the resistance in Gaza. (Photo by Probal Rashid/LightRocket via Getty Images)
Campus Activism
An Anonymous Group’s List of Purported Critics of Israel Helped Steer a U.S. Crackdown on Student Activists

From The Review

John T. Scopes as he stood before the judges stand and was sentenced, July 2025.
The Review | Essay
100 Years Ago, the Scopes Monkey Trial Discovered Academic Freedom
By John K. Wilson
Vector illustration of a suited man with a pair of scissors for a tie and an American flag button on his lapel.
The Review | Opinion
A Damaging Endowment Tax Crosses the Finish Line
By Phillip Levine
University of Virginia President Jim Ryan keeps his emotions in check during a news conference, Monday, Nov. 14, 2022 in Charlottesville. Va. Authorities say three people have been killed and two others were wounded in a shooting at the University of Virginia and a student is in custody. (AP Photo/Steve Helber)
The Review | Opinion
Jim Ryan’s Resignation Is a Warning
By Robert Zaretsky

Upcoming Events

07-31-Turbulent-Workday_assets v2_Plain.png
Keeping Your Institution Moving Forward in Turbulent Times
Ascendium_Housing_Plain.png
What It Really Takes to Serve Students’ Basic Needs: Housing
Lead With Insight
  • Explore Content
    • Latest News
    • Newsletters
    • Letters
    • Free Reports and Guides
    • Professional Development
    • Events
    • Chronicle Store
    • Chronicle Intelligence
    • Jobs in Higher Education
    • Post a Job
  • Know The Chronicle
    • About Us
    • Vision, Mission, Values
    • DEI at The Chronicle
    • Write for Us
    • Work at The Chronicle
    • Our Reporting Process
    • Advertise With Us
    • Brand Studio
    • Accessibility Statement
  • Account and Access
    • Manage Your Account
    • Manage Newsletters
    • Individual Subscriptions
    • Group and Institutional Access
    • Subscription & Account FAQ
  • Get Support
    • Contact Us
    • Reprints & Permissions
    • User Agreement
    • Terms and Conditions
    • Privacy Policy
    • California Privacy Policy
    • Do Not Sell My Personal Information
1255 23rd Street, N.W. Washington, D.C. 20037
© 2025 The Chronicle of Higher Education
The Chronicle of Higher Education is academe’s most trusted resource for independent journalism, career development, and forward-looking intelligence. Our readers lead, teach, learn, and innovate with insights from The Chronicle.
Follow Us
  • twitter
  • instagram
  • youtube
  • facebook
  • linkedin