├── README.md └── media ├── love_running_ethos.png ├── love_running_footer.png ├── love_running_gallery.png ├── love_running_landing.png ├── love_running_mockup.png ├── love_running_nav.png ├── love_running_signup.png └── love_running_times.png /README.md: -------------------------------------------------------------------------------- 1 | # Love Running 2 | 3 | In this section, you will include one or two paragraphs providing an overview of your project. Essentially, this part is your sales pitch. At this stage, you should have a name for your project so use it! Don’t introduce the project as a Portfolio project for the diploma. In this section, describe what the project hopes to accomplish, who it is intended to target and how it will be useful to the target audience. 4 | 5 | For example; Love Running is a site that hopes to help keep people motivated to meet up for runs on a regular basis in Dublin, Ireland. The site will be targeted toward runners who are looking for a way to socialise and keep themselves fit. Love Running will be useful for runners to see exactly when and where they should be to join the running club. 6 | 7 | ![Responsice Mockup](https://github.com/lucyrush/readme-template/blob/master/media/love_running_mockup.png) 8 | 9 | ## Features 10 | 11 | In this section, you should go over the different parts of your project, and describe each in a sentence or so. You will need to explain what value each of the features provides for the user, focusing on who this website is for, what it is that they want to achieve and how your project is the best way to help them achieve these things. 12 | 13 | ### Existing Features 14 | 15 | - __Navigation Bar__ 16 | 17 | - Featured on all three pages, the full responsive navigation bar includes links to the Logo, Home page, Gallery and Sign Up page and is identical in each page to allow for easy navigation. 18 | - This section will allow the user to easily navigate from page to page across all devices without having to revert back to the previous page via the ‘back’ button. 19 | 20 | ![Nav Bar](https://github.com/lucyrush/readme-template/blob/master/media/love_running_nav.png) 21 | 22 | - __The landing page image__ 23 | 24 | - The landing includes a photograph with text overlay to allow the user to see exactly which location this site would be applicable to. 25 | - This section introduces the user to Love Running with an eye catching animation to grab their attention 26 | 27 | ![Landing Page](https://github.com/lucyrush/readme-template/blob/master/media/love_running_landing.png) 28 | 29 | - __Club Ethos Section__ 30 | 31 | - The club ethos section will allow the user to see the benefits of joining the Love Running meetups, as well as the benefits of running overall. 32 | - This user will see the value of signing up for the Love Running meetups. This should encourage the user to consider running as their form of exercise. 33 | 34 | ![Club Ethos](https://github.com/lucyrush/readme-template/blob/master/media/love_running_ethos.png) 35 | 36 | - __Meetup Times section__ 37 | 38 | - This section will allow the user to see exactly when the meetups will happen, where they will be located and how long the run will be in kilometers. 39 | - This section will be updated as these times change to keep the user up to date. 40 | 41 | ![Meetup Times](https://github.com/lucyrush/readme-template/blob/master/media/love_running_times.png) 42 | 43 | - __The Footer__ 44 | 45 | - The footer section includes links to the relevant social media sites for Love Running. The links will open to a new tab to allow easy navigation for the user. 46 | - The footer is valuable to the user as it encourages them to keep connected via social media 47 | 48 | ![Footer](https://github.com/lucyrush/readme-template/blob/master/media/love_running_footer.png) 49 | 50 | - __Gallery__ 51 | 52 | - The gallery will provide the user with supporting images to see what the meet ups look like. 53 | - This section is valuable to the user as they will be able to easily identify the types of events the organisation puts together. 54 | 55 | ![Gallery](https://github.com/lucyrush/readme-template/blob/master/media/love_running_gallery.png) 56 | 57 | - __The Sign Up Page__ 58 | 59 | - This page will allow the user to get signed up to Love Running to start their running journey with the community. The user will be able specify if they would like to take part in road, trail or both types of running. The user will be asked to submit their full name and email address. 60 | 61 | ![Sign Up](https://github.com/lucyrush/readme-template/blob/master/media/love_running_signup.png) 62 | 63 | For some/all of your features, you may choose to reference the specific project files that implement them. 64 | 65 | In addition, you may also use this section to discuss plans for additional features to be implemented in the future: 66 | 67 | ### Features Left to Implement 68 | 69 | - Another feature idea 70 | 71 | ## Testing 72 | 73 | In this section, you need to convince the assessor that you have conducted enough testing to legitimately believe that the site works well. Essentially, in this part you will want to go over all of your project’s features and ensure that they all work as intended, with the project providing an easy and straightforward way for the users to achieve their goals. 74 | 75 | In addition, you should mention in this section how your project looks and works on different browsers and screen sizes. 76 | 77 | You should also mention in this section any interesting bugs or problems you discovered during your testing, even if you haven't addressed them yet. 78 | 79 | If this section grows too long, you may want to split it off into a separate file and link to it from here. 80 | 81 | 82 | ### Validator Testing 83 | 84 | - HTML 85 | - No errors were returned when passing through the official [W3C validator](https://validator.w3.org/nu/?doc=https%3A%2F%2Fcode-institute-org.github.io%2Flove-running-2.0%2Findex.html) 86 | - CSS 87 | - No errors were found when passing through the official [(Jigsaw) validator](https://jigsaw.w3.org/css-validator/validator?uri=https%3A%2F%2Fvalidator.w3.org%2Fnu%2F%3Fdoc%3Dhttps%253A%252F%252Fcode-institute-org.github.io%252Flove-running-2.0%252Findex.html&profile=css3svg&usermedium=all&warning=1&vextwarning=&lang=en#css) 88 | 89 | ### Unfixed Bugs 90 | 91 | You will need to mention unfixed bugs and why they were not fixed. This section should include shortcomings of the frameworks or technologies used. Although time can be a big variable to consider, paucity of time and difficulty understanding implementation is not a valid reason to leave bugs unfixed. 92 | 93 | ## Deployment 94 | 95 | This section should describe the process you went through to deploy the project to a hosting platform (e.g. GitHub) 96 | 97 | - The site was deployed to GitHub pages. The steps to deploy are as follows: 98 | - In the GitHub repository, navigate to the Settings tab 99 | - From the source section drop-down menu, select the Master Branch 100 | - Once the master branch has been selected, the page will be automatically refreshed with a detailed ribbon display to indicate the successful deployment. 101 | 102 | The live link can be found here - https://code-institute-org.github.io/love-running-2.0/index.html 103 | 104 | 105 | ## Credits 106 | 107 | In this section you need to reference where you got your content, media and extra help from. It is common practice to use code from other repositories and tutorials, however, it is important to be very specific about these sources to avoid plagiarism. 108 | 109 | You can break the credits section up into Content and Media, depending on what you have included in your project. 110 | 111 | ### Content 112 | 113 | - The text for the Home page was taken from Wikipedia Article A 114 | - Instructions on how to implement form validation on the Sign Up page was taken from [Specific YouTube Tutorial](https://www.youtube.com/) 115 | - The icons in the footer were taken from [Font Awesome](https://fontawesome.com/) 116 | 117 | ### Media 118 | 119 | - The photos used on the home and sign up page are from This Open Source site 120 | - The images used for the gallery page were taken from this other open source site 121 | 122 | 123 | Congratulations on completing your Readme, you have made another big stride in the direction of being a developer! 124 | 125 | ## Other General Project Advice 126 | 127 | Below you will find a couple of extra tips that may be helpful when completing your project. Remember that each of these projects will become part of your final portfolio so it’s important to allow enough time to showcase your best work! 128 | 129 | - One of the most basic elements of keeping a healthy commit history is with the commit message. When getting started with your project, read through [this article](https://chris.beams.io/posts/git-commit/) by Chris Beams on How to Write a Git Commit Message 130 | - Make sure to keep the messages in the imperative mood 131 | 132 | - When naming the files in your project directory, make sure to consider meaningful naming of files, point to specific names and sections of content. 133 | - For example, instead of naming an image used ‘image1.png’ consider naming it ‘landing_page_img.png’. This will ensure that there are clear file paths kept. 134 | 135 | - Do some extra research on good and bad coding practices, there are a handful of useful articles to read, consider reviewing the following list when getting started: 136 | - [Writing Your Best Code](https://learn.shayhowe.com/html-css/writing-your-best-code/) 137 | - [HTML & CSS Coding Best Practices](https://medium.com/@inceptiondj.info/html-css-coding-best-practice-fadb9870a00f) 138 | - [Google HTML/CSS Style Guide](https://google.github.io/styleguide/htmlcssguide.html#General) 139 | 140 | Getting started with your Portfolio Projects can be daunting, planning your project can make it a lot easier to tackle, take small steps to reach the final outcome and enjoy the process! 141 | -------------------------------------------------------------------------------- /media/love_running_ethos.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_ethos.png -------------------------------------------------------------------------------- /media/love_running_footer.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_footer.png -------------------------------------------------------------------------------- /media/love_running_gallery.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_gallery.png -------------------------------------------------------------------------------- /media/love_running_landing.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_landing.png -------------------------------------------------------------------------------- /media/love_running_mockup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_mockup.png -------------------------------------------------------------------------------- /media/love_running_nav.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_nav.png -------------------------------------------------------------------------------- /media/love_running_signup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_signup.png -------------------------------------------------------------------------------- /media/love_running_times.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/Code-Institute-Solutions/readme-template/ac0a8d172619a4c34a4ef4216cb2ee937fd1992a/media/love_running_times.png --------------------------------------------------------------------------------