This is the documentation for the XL-Mentoring, Wrexham website. The site has been built using HTML5 & CSS3 with minor javascript elements created through the use of Bootstrap for the Milestone 1 project for Code Institute's web development diploma.
- XL-MENTORING-WREXHAM - ReadME
This project is inspired by a real charity that exists in Wrexham, Wales. The aim of the website is to broaden the opportunities to recruit volunteers. The charity doesn't have a shortage of young people being referred to by schools but has a shortage of volunteer mentors. The Project Manager is mindful that parents, guardians, teachers and young people will have access to this sight. With this in mind it needs to be informative without it being academically out of reach for people who might struggle. Images to describe the journey and process were considered to be key. So it was requested that a hiking journey would be appropriate as we are surrounded by hills and Snowdonia is nearby.
-
First Time Visitor Goals
a. As a first time visitor, I want to be able to easily understand the purpose of the website and to learn more about the charity.
b. As a first time visitor, I want to be able to easily navigate the site to access content without having to use the back button at any time.
c. As a first time visitor, I want to look for testimonials to understand the benefits of the charity to young people. I also want to locate the charities social media links to see their followings on social media to determine how trusted and how well known they are.
-
Returning Visitor Goals
a. As a returning visitor, I want to be able to find infomation easily to show others.
b. As a returning visitor, I want to know how to contact the business for more information.
-
Frequent User Goals
a. As a frequent user, I want to confidently recommend the charity to others.
b. As a frequent visitor, I want to be able to check for new training days and discover what current opportunities the charity has had.
Taking all of the above into account I decided that we would need three main pages to begin with;
- Home Page: This would provide users with charities motto along with some testimonials from young people who have benefited from the charity
- About Us Page: This would provide crucial information covering who its for, who can volunteer, how it works and safeguarding
- Contact Page: This would allow users to ask for more information and to show interest.
As well as the three main pages, links to the charities social media page, charity registration number and accreditations would be clearly shown in the footer to direct users to other sites.
These three pages give the Project Manager a good starting idea about the potential for having their own website with room to expand the site to include more features in the future.
The navigation route will be linear and will encourage users to go on a journey to learn about the work the charity does, the benefits to young people and then opportunity to contact the charity for more information. This will be the order that the pages appear in the navigation bar.
All wireframes have been created with using a basic drawing add -on on Google Docs
The wireframes featured here are the initial design idea for the webpage. Some styling elements have been changed since the wireframes were drawn because we used different images which we felt were more modern. For example: instead of using two images with a young boy and girl looking through a telscope we chose to use one image of a mobile phone being held to take a picture of the view of the mountains before they go on a hike.
Fonts have been imported from Google Fonts.
-
Alumni Sans Pinstripe This font has been used for the header as it was the nearest to the current XL-Mentoring Logo. Mohave is the fallback font followed by Sans Serif. We chose this style of font as it was the nearest to what is currently used for the logo and it keeps the continuity and identity of the charity.
-
Mohave This font has been used for the main text across the site with "sans-serif" as fallback if the browser doesn't import the font correctly. We felt this was more readable than the above Alumni Sans Pinstripe but a a very similar style. We didn't want to have too many different fonts as it can make the webpage look too busy.
I used Canva to research a colourscheme for the site. Based on the overview of the site I knew we wanted to include colors which reflected the outdoors and at the same time the welsh red and green which is important to this area.
-
#BA2222 is the colour I chose for the "X" in Wrexham in the header. We thought it symbolised the welsh dragon above the green navigation bar giving it a sophisticated look. I also used an opaque version for some of the backgroud text boxes.
-
#267C31 - This forest green is the colour I chose for the navigation bar as I felt it was an outdoor countryside green which complimented the images I've used and it was a good representation for the welsh flag.
-
#2C2727 - This charcoal-grey color I chose is softer on the eyes compared to a definite black. The charcoal grey used in the footer, header text, shadows and also an opaque version was used for the boxes that contained links.
-
#F0F8FF - Also known as Aliceblue, this color was used for the text in boxes. I felt it was a good contrast to the background box colors above but softer than a harsh white.
As XL-mentoring already has merchandise with "XL-Mentoring" written on the items with a particular style I wanted to keep the brand identity on the website. Also the reason the color green was chosen for the navigation bar with the red x in Wrexham was to show welsh loyalty which is important in Wales. I decided to centralise the header to keep it symmetrical and draw people eyes to the middle of the screen where key testimonies can be found. The listed navigation links all have animation to help the user know when they are hovering over the link correctly. This layout also works well on mobile and smaller screens.
On larger screens the footer is horizontal and with a easily readable size font. It was felt by the client that the footer wasn't to be an advertising placard so we kept it subtle. On mobile screens the footer changes direction and becomes vertical.
On the home page the hero image is of a person taking a picture of the mountain landscape before going on a hike. This was chosen to suggest that users were going on a journey. It was also felt that the mobile phone appealed to a wider demographic.
The homepage has a person taking a mountain view with a mobile phone. On-top of this is two links. One being an audio testimony from a young person and the second being a pdf written testimony from a mentor to be downloaded. The home-page also has the charities motto. Further down are other testimonies from young people.
Using bootstrap's grid styling and card classes, the About Us page has a responsive layout that changes for three different breakpoints. On large screens the image goes to the left of the screen and the textboxes are standing on the right. For medium to small size screens the text boxes sit on top of the image so you can still see the dramatic scenery. This is different from my original plan of having a circle to represent the view from binoculars and text being in the four quadrants of the circle.
The Contact page has a responsize design. The image sits to the left of the form and the picture shows a person who has reached the top of the mountain. All fields have to be filled in for the Submit button to work. In all fields the words "Required" are also visible so the user knows what is needed.
-
A gallery was planned to be added with addition of media links to highlight the media profile the charity has.
-
A Welsh translation is being considered but is on hold as the Project Manager doesn't speak Welsh and we didn't want users to expect a welsh speaker at the end of the phone or email.
-
A page designated to who the Project Manager is, so users don't feel they are sharing information with an Artifical Intelligence.
-
Address some of the gaps when viewing on larger screens and consider including another page so some of the pages appear less cramped which would make it look less busy.
Alternative text has been included for all images across the site, including all images within the readme file.
Aria labels have been included for all links across the site, as well as the copyright icon in the footer.
The main font is plain and easy to read. The cursive font used for the main heading and various sections throughout has been styled with extra letter spacing to make it easier to read.
- Bootstrap V4.3 - For the framework for the website. Code for the navigation bar, About Us, Contacts Us were used and modified. Additional CSS styling was also implemented in style.css.
- Google docs - The draw and paint utilities were used for wireframes and other graphics in readme.
- Font Awesome - For the icons on the website.
-
Git - For version control.
-
Github - To save and store the files for the website.
-
Google Dev Tools - To troubleshoot and test features, solve issues with responsiveness and styling.
-
Google Fonts - To import the fonts used on the website.
- Freepik - For stock image.
- UI.dev - To show the site on a range of screen sizes.
Github Pages was used to deploy the live website. The instructions to achieve this are below:
- Log in (or sign up) to Github.
- Find the repository for this project, xlmentoringwxh.
- Click on the Settings link.
- On the left-hand side, you will see a sub-heading called "code and automation" with link called "Pages" click this link.
- Below the title "Build and Deployment" you will see "Branch" click the dropdown called "None" and selct "Main".
- Next click the dropdown called "docs" and select "root" then save.
- The page sould automatically refresh.
- At the top of the repository there will be a box with Visit Site button, to view the published website.
To fork the Folded-Fairy repository:
- Log in (or sign up) to Github.
- Go to the repository for this project.
- Click the Fork button in the top right corner.
To clone the Folded-Fairy repository:
- Log in (or sign up) to Github.
- Go to the repository for this project.
- Click on the code button, select whether you would like to clone with HTTPS, SSH or GitHub CLI and copy the link shown.
- Open the terminal in your code editor and change the current working directory to the location you want to use for the cloned directory.
- Type 'git clone' into the terminal and then paste the link you copied in step 3. Press enter.
Please see testing.md for all testing elements of this site.
-
w3schools: To confirm how to add audio player and pdf
-
Bootstrap: Insert the cards, navigation bar, footer, contact form and to use the grid system for the layout.
-
Code Institute - Love Running Mini Project: Support with styling within style.css and code from the form challenge and using the form dump.
-
Code Institute - Introduction to Bootstrap: Support with styling through Bootstrap including how to use the grid system.
-
Stack Overflow: Using Bootstrap to hide and show elements of nav bar on different screen sizes.
-
W3Schools: Text area in contact form.
-
Freepik: Used to source all images for the site.
-
UI.dev: Used to generate images that showcase the responsive design within the readme file.
-
Project Manager: Written text to copy and paste and give an outline of what information was to be added.
-
Rahul Lakhanpa - Mentor: For the encouragement and providing insights into building my project.
-
Iris Smok - Cohort Facilitator: For hosting informative standup's and providing a great class atmosphere and giving some 1:1 guidance.
-
Class June 2023: Everyone in my class channel on slack who is involved with the stand ups and group chat for contributing to the great atmosphere and supportive environment.
-
The wider slack community: For quick responses to various issues and questions I had at all stages of the project.