Skip to content

Based of Code-Institutes gitpod template, removed previous readme and added my own readme template

Notifications You must be signed in to change notification settings

DeannaCarina/BaseTemplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PROJECT TITLE HERE

Contents


Introduction

Portfolio Project [NUMBER]: [MODULE NAME] - Code Institute - Deadline [DEADLINE DATE]

BRIEF INTRODUCTION HERE (ABOUT 5 LINES)

Demo

A live of the website can be found HERE [INSERT LINK TO DEPLOYED SITE HERE] [Insert responsive gif/image here]

UX

BRIEF INTRODUCTION TO UX HERE (ABOUT 3 LINES)

Strategy

Vision

VISION OF THE PROJECT HERE (ABOUT 15 LINES)

Aims

  1. AIM 1
  2. AIM 12
  3. AIM 3
  4. MORE AIMS...

Target Audience(s)

  1. TARGET 1
  2. TARGET 12
  3. TARGET 3
  4. MORE TARGETS...

User Stories

  1. STORY 1
  2. STORY 12
  3. STORY 3
  4. MORE STORIES...

Feasibility vs Importance

Opportunity/Feature Feasibility/Viability (score out of 5) Level of Importance (score out of 5) In or out?
FEATURE 1 HERE F/V SCORE HERE IMPORTANCE SCORE HERE IN OR OUT?
FEATURE 2 HERE F/V SCORE HERE IMPORTANCE SCORE HERE IN OR OUT?
FEATURE 3 HERE F/V SCORE HERE IMPORTANCE SCORE HERE IN OR OUT?
MORE FEATURES HERE F/V SCORE HERE IMPORTANCE SCORE HERE IN OR OUT?
Average Viability x number of features:
SCORE HERE
Sum of Importance:
SCORE HERE

EXPLAINATION OF TABLE HERE

The table above has been plotted into a graph (below) to easily visualise the features that will be implemented into the web application and which ones won't be:

  • The features in the pink section will be implemented
  • The features in the grey section could/should be implemented however I might find it difficult due to my own coding knowledge
  • The features in the turquoise section will not be implemented as it would be unwise to focus on these features until a later date


[IMAGE OF TABLE] [IMAGE OF GRAPH]

Scope

ADVANTAGES/DISADVATAGES OF EITHER MMP OR MVP AND WHY WE ARE USING THE OPPOSING MODEL

By using the [INSERT MODEL HERE] model we will:

While following the [INSERT MODEL HERE] model, to meet the user and business goals, our website will include:
  • FEATURE 1
  • FEATURE 2
  • FEATURE 3
  • FEATURE 4
  • MORE FEATURES...

Structure

LINEAR/NON-LINEAR?

On PAGENAME: FEATURES
On PAGENAME: FEATURES
On PAGENAME: FEATURES

Skeleton

The wireframes for the PROJECT NAME HERE website application were made with WIREFRAME SOFTWARE HERE, they can be found by viewing the images below. WHY MOBILE/DESKTOP FIRST APPROACH?

PAGENAME

PAGENAME

PAGENAME

The wireframes were created during the website application's initial desgin process, as such there are changes between the layout of the wireframes and the final layout/design of the finished website.

Surface

Typography

Colour Scheme

Icons

Images & Videos

Technologies

Features

Implemented Features

Features Left to Implement

Testing

Functionality

Compatibility

User Testing Stories

Code Validation

Issues Found During Deployment

Accessibility

Performance Testing

Deployment

A live demo of the website can be found HERE

Project Creation

This project was created on GitHub and Edited in GitPod by carrying out the following:

  1. A new repository was created using 'Code-Instutute-Org/gitpod-full-template'
  2. A meaningful name was given to the new repository and 'Create Repository' was selected
  3. The repository was then opened on GitHub by clicking the 'Gitpod' button to build the GitPod workspace which would allow me to build and edit the code used to make the PROJECT NAME HERE website/application
  4. Version control was used throughout the project using the following commands in the terminal using Bash
    • git add . OR git add "file name" - to stage the changes and get them ready for being committed to the local repo.
    • git commit -m "Description of the update" - to save the change and commit the change to the local repo
    • git push - to push all committed shanges to the GitHub repo associated with the GitPod workspace
  5. Project Deployment

    This project was deployed via Heroku by carrying out the following:

    1. Create the gitpod repo from the template via the gitpod button in github.
    2. Log in to Heroku and create a new app.
    3. Add the postgres add-on
    4. Complete the config vars section
    5. Link Heroku and GitHub accounts together
    6. Select the repo (via Heroku) that I wanted to make an app of and give it a name in Heroku.
    7. Click on deploy.

    Local Deployment

    There are many ways to deploy the project locally on your own device. The ways I will explain here are: Forking, Cloning, GitHub Desktop and Zip Exctraction, the steps in these processes are outlined below:

    Forking the GitHub repo

    If you want to make changes to the repo without affecting it, you can make a copy of it by 'Forking' it. This will make sure that the original repo remains unchanged.

    1. Log in to your GitHub account
    2. Navigate to the repository HERE
    3. Select the 'Fork' button in the top right corner of the page (under your account image)
    4. The repo has now been copied into your own repos and you can work on it in your chosen IDE
    5. If you have any suggestions to make regards to the code to make the site better, you can put in a pull request
    6. If you want to create a web-app from the repo please follow the instructions in "Project Deployment"

    Cloning the repo with GitPod

    1. Log in to your GitHub account
    2. Navigate to the Repository HERE
    3. Select the 'Code' button above the file list on the right had side
    4. Ensure HTTPS is selected and click the clipboard on the right of the URL to copy it
    5. Open a new workspace in GitPod
    6. In the bash terminal type 'git clone [copy url here from step 4]'
    7. Press enter - the IDE will clone and download the repo
    8. You can then type 'python3 -m http.server' to host the website locally - this will not run the python file, only allow you to check how the web-app looks.
    9. If you want to create a web-app from the repo please follow the instructions in "Project Deployment"

    Github Desktop

    1. Log in to your GitHub account
    2. Navigate to the Repository HERE
    3. Select the 'Code' button above the file list on the right had side
    4. Select 'Open with GitHub Desktop'
    5. If you haven't already installed GitHub desktop application - you will need to follow the relevant steps to do this
    6. The repo will then be copied locally onto your machine
    7. If you want to create a web-app from the repo please follow the instructions in "Project Deployment"

    Download and extract the zip directly from GitHub

    1. Log in to your GitHub account
    2. Navigate to the Repository HERE
    3. Select the 'Code' button above the file list on the right had side
    4. Select 'Download Zip'
    5. Once you have the Zip downloaded, open it with your prefered file decompression software
    6. You can then drag and drop the files from the folder into your chosen IDE or view/edit them on your local machine
    7. If you want to create a web-app from the repo please follow the instructions in "Project Deployment"

    Credits

    Code

    Content

    Images

    Video

    Acknowledgements

    Screenshots

About

Based of Code-Institutes gitpod template, removed previous readme and added my own readme template

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published