HobbaZ / README-template

A template for structuring README's

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

README TEMPLATE

License License Github Commits GitHub latest commit GitHub followers GitHub repo size GitHub issues GitHub forks GitHub language count GitHub search hit counter

Go to shields.io to see what other badges you can add to your projects (to use the ones above, just change to your username and repo)

Description

Project Aim

Ever needed a professional README layout but didn't know where to start? Use this template to quickly develop a professional README.

Change the sections with your own text.

You can add code blocks and other font stylings to your README via the markdown syntax, look at this mastering markdown link for more information.

What Problem Does It Solve

Solves the programmer's most gruelling and hated task, documentation.

What I Learnt

Put what skills you learnt or advanced upon here.

Deployment

You can view the website link here.

Table of Contents

User Story

GIVEN a basic application description (e.g. GIVEN a command line application that accepts user input)

WHEN I do something (e.g. WHEN I click a button)

THEN some action happens (e.g. THEN I am redirected to repo owner's Github page)

Repeat WHEN and THEN until all major project needs have been defined

Screenshots

Cool example image Photo by <a href="https://unsplash.com/@ffstop?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Fotis Fotopoulos</a> on <a href="https://unsplash.com/s/photos/programming?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a>

Cool example photo by Photo by <a href="https://unsplash.com/@altumcode?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">AltumCode</a> on <a href="https://unsplash.com/s/photos/programming?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText">Unsplash</a>

Installation

You will need: Github, VS Code, Gitbash

  1. Click Use this Template

  2. Enter a name for your repo

  3. Git clone new repo to your computer by right clicking SSH link in your repo, then open gitbash and type:

    'git clone'

    Then right click next to git clone text and your SSh link will be pasted in for you, hit enter and wait as it compiles

  4. Open the repo in your editor software and edit the README to your values

Features

  • Clickable table of contents
  • Easily modifiable for more sections, more images, etc
  • Badges

Technology

List tech stack you used to create your project here (e.g. Node.js, Inquirer npm package, Github API)

  • Github

Contributors

Zachary Hobba

You can also contribute by opening a pull request or submitting an issue

Acknowledgements

Put url's of website's that helped you in creating your project here. E.g.

Google Fonts Lalezar

Shields.io

Coolers

Testing

List any unit tests you've created for your project here

License

This is the licence conditions you apply to your project (e.g. limitations on how it can be used, if they need to attribute you as the creator).

Remember to change the copyright text to the current year and your name!

View licences available at choosealicence website

MIT

Copyright 2021 Zachary Hobba

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Questions

Change these to your values

Find me on Github at HobbaZ Email me at zachobba@gmail.com

About

A template for structuring README's

License:MIT License