Skip to content
General Program
Panel information
In-Person Participant info
Online Participant info
IN-CONFERENCE EXCURSION REGISTRATION
Support IASC
  • About the Conference
    • Welcome & Introduction
    • Conference Theme & Sub-themes
    • Accepted Panels
    • Information for Online Participants
    • Pre-conference workshops
    • Organizers
    • Sponsors
    • Hosting institutions
    • Elinor Ostrom Award
    • Contact us
  • Information for Online Participants
  • Visas
    • Visa Information
    • IASC membership
  • Schedules & guidelines
    • General Program
    • Accepted Panels grouped in 12 sub-themes
    • Author Index
    • Important Dates
    • Conference Venue
  • Excursions
    • In-Conference Excursions — Thursday June 19th, 2025
    • Post-Conference Excursions — June 21 – 22, 2025
  • Fees, Travel, Food & Lodging
    • Conference Registration Fees
    • Travel
    • Food at the Conference
    • Participant Lodging
  • About the Conference
    • Welcome & Introduction
    • Conference Theme & Sub-themes
    • Accepted Panels
    • Information for Online Participants
    • Pre-conference workshops
    • Organizers
    • Sponsors
    • Hosting institutions
    • Elinor Ostrom Award
    • Contact us
  • Information for Online Participants
  • Visas
    • Visa Information
    • IASC membership
  • Schedules & guidelines
    • General Program
    • Accepted Panels grouped in 12 sub-themes
    • Author Index
    • Important Dates
    • Conference Venue
  • Excursions
    • In-Conference Excursions — Thursday June 19th, 2025
    • Post-Conference Excursions — June 21 – 22, 2025
  • Fees, Travel, Food & Lodging
    • Conference Registration Fees
    • Travel
    • Food at the Conference
    • Participant Lodging

Gaughan, Matthew

Author

Session 5. 5.
Monday, June 16, 2025 3:30 PM – 5:00 PM Hasbrouck Hall HAS 137
The Introduction of README Files and Contributing Guidelines in FLOSS Peer-Production
in-person
Matthew Gaughan
Northwestern University, United States

Documentation, such as README and CONTRIBUTING files, can serve as the first point of contact for potential contributors to free/libre and open source software (FLOSS) projects. Prominent open source software organizations such as Mozilla, GitHub, and the Linux Foundation advocate that projects provide community-focused and process-oriented documentation early on in order to foster contributor recruitment, expand the project's commons, and drive peer-production activity. In this paper, we investigate the introduction of README files and contributing guidelines in FLOSS projects, as well as whether early documentation conforms to these recommendations or explains subsequent activity in communities. We use a novel dataset of FLOSS projects packaged by the Debian GNU/Linux distribution and conduct a quantitative analysis to examine README (n=2280) and CONTRIBUTING (n=452) files when they are first published into projects' repositories. To analyze changes in project activity, we use random effects coefficients generated by longitudinal multilevel models fit to weekly project contribution data. We find that projects often publish READMEs ritualistically at the beginning of development yet introduce CONTRIBUTING files later in project lifecycles, following an influx of contributions. The initial versions of these files rarely focus on community development, and instead describe organizational processes and offer technical summaries. Our findings suggest that FLOSS projects do not create documentation with community-building in mind, but rather brevity, usage, technical features and processes. Our results raise broader questions of the disconnect between prevailing wisdom in FLOSS commons governance and in-the-wild project management.

  • General Program
  • Panel Schedule Oral Presentations
  • Poster Presentations
  • IASC 2025 Social System Map
  • IASC 2025 Slack Workspace
  • Teamup Calendar (also see below in your local time)
  • General Program
  • Panel Schedule Oral Presentations
  • Poster Presentations
  • IASC 2025 Social System Map
  • IASC 2025 Slack Workspace
  • Teamup Calendar (also see below in your local time)

About the Conference

Welcome & Introduction

Conference theme & sub-themes

Online Components

Pre-conference workshops

Organizers

Sponsors

Hosting Institutions

Elinor Ostrom Award

Contact Us

Visas, registration & payments

Visa Information

IASC Membership

Registration

Schedules & Guidlines

Important Dates

Call for Contributions

Panels in Progress

Conference Venue

Conference Excursions

In-Conference Excursions

Post-Conference Excursions

Fees, Travel, Food & Lodging

Conference Registration Fees

Travel

Food at the Conference

Participant Lodging

Facebook-f X-twitter Linkedin

© 2025 | Privacy & Cookies Policy

Made with 🤟🏻 by Pfister Lab