Skip to content

Instantly share code, notes, and snippets.

@AlessandraSozzi
Last active February 8, 2017 16:27
Show Gist options
  • Save AlessandraSozzi/c6a6e8ea24221c13df4dff3480e759bf to your computer and use it in GitHub Desktop.
Save AlessandraSozzi/c6a6e8ea24221c13df4dff3480e759bf to your computer and use it in GitHub Desktop.
README structure

Project Title

Overview

At the top of the file there should be a short introduction and/ or overview that explains what the project is.

  • Explanation of the application and its purpose. Answer the questions:
    • What is the motivation behind the creation of the project? This should explain why the project exists.
    • Why is this project relevant to the user?
    • What purpose does it serve?

What does it do?

If relevant, provide a more detailed explanation of what the the project/app/library does.

How do I use it?

Requirements/Pre-requisites

List any requirements for using this project, like dependencies and version. Remove this section if it is not needed.

How to run the project locally

Include instructions on how to run the project on a user's local machine. Be sure to reference the technologies they might have to download for the application to run.

  1. Step 1

  2. Step 2

    • Substep (a)
    • Substep (b)
  3. Step 3

    Your code here
    

Project Structure

Use the below for Markdown formatting syntax:

Sub Section

This is a blockquote.

This is the second paragraph in the blockquote.

  • list item #1
  • list item #2
  1. ordered item #1
  2. ordered item #2

This is a code snippet

This is a code block

This text will be italic

This text will be bold

First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

To create a hyperlink to www.github.com, with a link text that says, Visit GitHub!, you'd write this in Markdown: Visit GitHub!

Data

For example when no data are provided in the project, could be helpful to provide how the data should be structured in order to try the model. Remove this section if it is not needed.

Example JSON file

{
  "user_id": 0001,
  "profession": "Data Scientist"
}

Useful links

Remove this section if it is not needed.

Publication
Additional link
Additional link

Contributors

Include a section for credits in order to highlight and link to the authors of your project. Apart from listing contacts of specific people involved in the project, aslo include the general email to the ONS Big Data project

License

MIT? OGL?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment