Skip to content

GitLab

  • Projects
  • Groups
  • Snippets
  • Help
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
  • Sign in / Register
GHC
GHC
  • Project overview
    • Project overview
    • Details
    • Activity
    • Releases
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 4,262
    • Issues 4,262
    • List
    • Boards
    • Labels
    • Service Desk
    • Milestones
    • Iterations
  • Merge Requests 415
    • Merge Requests 415
  • Requirements
    • Requirements
    • List
  • CI / CD
    • CI / CD
    • Pipelines
    • Jobs
    • Schedules
  • Security & Compliance
    • Security & Compliance
    • Dependency List
    • License Compliance
  • Operations
    • Operations
    • Incidents
    • Environments
  • Analytics
    • Analytics
    • CI / CD
    • Code Review
    • Insights
    • Issue
    • Repository
    • Value Stream
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Members
    • Members
  • Collapse sidebar
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
  • Glasgow Haskell Compiler
  • GHCGHC
  • Wiki
    • Working conventions
  • documentation changes

Last edited by Icelandjack Jul 15, 2019
Page history New page

documentation changes

How to change GHC's documentation

GHC runs on GitLab: https://gitlab.haskell.org/ghc/ghc

Small changes only change comments, not code. Limited to one file.

The continuous integration testing also has slow turnaround. Make sure not to add trailing whitespace :) but don't be afraid to submit fixes. We appreciate your contribution.

Small changes

The simplest way to contribute patches is using the GitLab web interface. To write a patch for Control.Monad you would go to libraries/base/Control/Monad.hs where the Edit button takes you to an online editor:

Screenshot_from_2019-07-15_14-17-52

Change the documentation, write a descriptive commit message and Commit changes.

This takes you to New Merge Request: Follow the instructions and finally Submit merge request.

That's it!

Big changes

Updating GHC's documentation is easy, and can benefit newcomers greatly!

GHC's documentation is included within in its source code, using Haddock's markup.

Here are the steps to modify it:

  1. Create a Merge Request on GitLab.
  2. Wait for the reviewers to look at your patches. If this takes more than a week, complain!
  3. Wait for bgamari to publish the documentation. (As of Nov 2017, he runs the publish script manually, about once a month.) If this takes more than a month, complain on the #ghc channel on FreeNode!

Then have a beer on us. We are truly grateful.

Clone repository

GHC Home
GHC User's Guide

Joining In

Newcomers info
Mailing Lists & IRC
The GHC Team

Documentation

GHC Status Info
Working conventions
Building Guide
Debugging
Commentary

Wiki

Title Index
Recent Changes