Creating a README

Introduzione ai concetti di GitHub

Jasmin Ludolf

Content Developer, DataCamp

Edit the README

View of the soccer analysis repo

Introduzione ai concetti di GitHub

Edit the README

View of the soccer analysis repo with the README file highlighted

Introduzione ai concetti di GitHub

Edit the README

View of the soccer analysis repo with the pencil icon to edit the README file highlighted

Introduzione ai concetti di GitHub

Markdown

View of the README file

Introduzione ai concetti di GitHub

Edit vs. Preview

View of the README file highlighting the edit and preview tabs

Introduzione ai concetti di GitHub

Headings

View of a markdown file edit page with syntax for the largest heading

View of a markdown file preview page with the largest heading

Introduzione ai concetti di GitHub

Headings

View of a markdown file edit page with syntax for all six heading types

View of a markdown file preview page with all six heading types

Introduzione ai concetti di GitHub

Headings

View of a markdown file edit page with syntax for all six heading types]

View of a markdown file preview page with all six heading types and arrows pointing to the lines under heading one and heading two

Introduzione ai concetti di GitHub

Text formatting

View of a markdown file edit page with syntax for bold and italics

View of a markdown file preview page with bold and italic text

Introduzione ai concetti di GitHub

Hyperlinks

View of a markdown file edit page with syntax for a hyperlink

View of a markdown file preview page with a hyperlink

Introduzione ai concetti di GitHub

Hyperlinks

Animated view of clicking a hyperlink

Introduzione ai concetti di GitHub

Images

Animated view dragging an image into the markdown file and GitHub automatically rendering the syntax

Introduzione ai concetti di GitHub

Writing a README

  • Need to be descriptive
    • Anyone should understand our project
  • List the contents of the repository
  • Clearly explains the project to others

Illustration of an open book

Introduzione ai concetti di GitHub

README fundamentals

  • Title
  • Description of technology
    • Why?
  • Description of the process
    • Why?
  • Table of contents
Introduzione ai concetti di GitHub

README extras

  • How the project came about
  • The motivation
  • Limitations
  • Challenges
  • What problem it hopes to solve
  • What the intended use is
  • Credits
Introduzione ai concetti di GitHub

Let's practice!

Introduzione ai concetti di GitHub

Preparing Video For Download...