Creating a README

Giới thiệu về các khái niệm GitHub

Jasmin Ludolf

Content Developer, DataCamp

Edit the README

View of the soccer analysis repo

Giới thiệu về các khái niệm GitHub

Edit the README

View of the soccer analysis repo with the README file highlighted

Giới thiệu về các khái niệm GitHub

Edit the README

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

Giới thiệu về các khái niệm GitHub

Markdown

View of the README file

Giới thiệu về các khái niệm GitHub

Edit vs. Preview

View of the README file highlighting the edit and preview tabs

Giới thiệu về các khái niệm 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

Giới thiệu về các khái niệm 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

Giới thiệu về các khái niệm 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

Giới thiệu về các khái niệm 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

Giới thiệu về các khái niệm GitHub

Hyperlinks

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

View of a markdown file preview page with a hyperlink

Giới thiệu về các khái niệm GitHub

Hyperlinks

Animated view of clicking a hyperlink

Giới thiệu về các khái niệm GitHub

Images

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

Giới thiệu về các khái niệm 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

Giới thiệu về các khái niệm GitHub

README fundamentals

  • Title
  • Description of technology
    • Why?
  • Description of the process
    • Why?
  • Table of contents
Giới thiệu về các khái niệm GitHub

README extras

  • How the project came about
  • The motivation
  • Limitations
  • Challenges
  • What problem it hopes to solve
  • What the intended use is
  • Credits
Giới thiệu về các khái niệm GitHub

Let's practice!

Giới thiệu về các khái niệm GitHub

Preparing Video For Download...