Friday, 23 October 2015

Week 12: Help and content

Lots of small fixes and additions this week.  I added real content to the help and getting started pages with efforts to top and front load content.  In addition to adding help content, I also added a link to Help on the Errors section of the Working panel page in line with user feedback.  I initially linked this Help to a modal lightbox but thought it would be more useful to have it pop-out into a new window.  This way users could view help (and go onwards to the help links) while still viewing and editing the Working panel page.  I used a plugin from http://www.quackit.com/javascript/popup_windows.cfm to achieve this. Help was also moved out of 'About' on the Nav and up to the top section so it is viewable without having to click down further into the nav.  

The other main achievement for this week was making a solid start on the Part C report.  I copied the dot points mentioned on the deco1800 website and wrote paragraphs relating to each point, tagging group members in sections where they needed to write for items I couldn't answer (e.g. problems they had solved).


Friday, 16 October 2015

Week 11: Optimisation and new 'My restorations'

This week started the final stretch where we begun optimising and finessing code/elements.  Based on feedback, we also took another look at how 'My restorations' worked.

Home page

Now that the Trove API calls and adding the images to the Home page works, I looked at how we could make the API calls run faster as it is quite slow.  Each image is retrieved with a separate API call based on a relevant keyword search limited to 50 results.  As I curated the images we used to illustrate each website, I could limit the API calls to return only the number of results required to included the image needed.  I went through each query, found which number the desired image was in the list, and then changed the API call to reflect only that number of results.  For some calls, that meant reducing the query from 50 results to 2 results and overall, this improved the loading speed of this page.  It was a bit tedious but worthwhile.  After I had completed it I spoke to another student of this course who suggested creating a list on Trove with only the desired images to call but as I had already refined our queries, I added this to the 'if there's time list' and left it at that for the time being.

It seems like there is often a 'better' way to do things, best practice, easy, optimised, etc, that I don't discover until I have spent hours using trial and error and stack overflow to just get it to work.  This can be really frustrating.  It is definitely rewarding to figure something out yourself and get something that hasn't worked after hours and hours of trying to finally work.  But, it is hard to accept a 'better' way to do something that is different to the way I figured out because of the time involved.

This week in 'PHP'

I added the logout function to all pages in the nav which meant re-saving all the pages as.php, not .html to make this work.


Working panel - HTML Editor
In response to feedback received I changed the HTML editor (and CSS editor) to wrap text so users don't have to scroll sideways to view long lines of code.

This is a feature of the ACE Editor and only required the addition of one line:
    aceEditor.getSession().setUseWrapMode(true);

My restorations

This week we changed how my restorations worked in response to adding modules last week.  I realised that by adding modules, it became confusing how users access these modules.

Previous flow:
Home (choose website) > Website page (displaying modules) > Working Panel > My restorations (displays saved websites).

To access the second module, a user would have to return to the Home page and reselect the website as we did not provide navigation links to each website.

New flow:
Home (choose website) > Working Panel (module 1) > My restorations (dynamically displays websites and modules indicating which modules have been started).

To accomplish this I did the following:

  • Got rid of individual website pages and replaced them with individual html file with only the website module information (ie not head or body, just a div)
  • Created a plunkr to test using Javascript to add html snippets to a page based on hardcoded variables
  • Created an AngularJS repeater function to add divs with IDs to the 'My restorations' page so there is an empty, targetable div on the page for each website
  • Make the Javascript work with PHP variables to tell when a module has been saved or not.

Using PHP variables in Javascript

To use the PHP variables in javascript, they need to be converted, e.g. var cricket = <?php echo (json_encode($cricket_start)); ?>;.  Where ‘cricket’ is a new Javascript variable and ‘$cricket_start’ is a variable in PHP that we need access to.  The syntax for converting variables was easily found using a Google search but the javascript file did not work as expected when added to the top of a modules.js file.  Knowing that the hardcoded variables worked, I knew it was the variables, not the Javascript that was the problem. The simple fix for this turned out to be converting the variables in a script tag on the my_restorations.php page rather than the modules.js file. 


Thursday, 15 October 2015

Week 11: Feedback update

Here is the amalgamated feedback we have received to date (Part A presentation, paper prototype, Part B presentation, Digital prototype) and how we have or will incorporate it into our design.

Done! Will do (but haven't yet) Might do (if there's time) update


Feedback

When

Responses

Levels/Gamification

Add gamification including level up, easy/hard mode, or points for completion. Hard mode could include editing without validating first (see if you can find the errors yourself). Part A
/Digital prototype
Easy/hard mode has been added.  
Easy/hard has been changed to modules.  Easy levels have smaller modules, code is broken up into chunks

Content

Add in option for users to find out more about their content.  Could be through linking back to trove to search topic. Part A Will add if there's time.
Tangential learning is a sub-goal of our product. Users will already be learning through the content provided within the websites. 
Have multi-user option (like google drive) or set up a study group to work on problem together to solve collaboratively. Part A Context of use is for classrooms or extension work.  The style of problem is more suited to individual learning.  We will add a commenting feature for other user’s projects if there is time. Likely we will not have time to implement this feature.

Help

How do users get help?  Could add chat panel or discussion board.

Make help more obvious on editor page
Part A
/Digital prototype
Help section has been added.  
Help similar to codeacademy where they link to relevant stack overflow discussions.
Will include glossary page with information from W3C on tags and tag changes across versions.
Will move help button to errors panel.  
Will make help a pop-out if time.

Audience

Concerns that initial audience of grade 7 & 8 students is too young. Part A Did further research that is discussed in previous blog post.

Audience has been modified
Web historians is for people:
  • who are familiar with HTML and CSS but still beginners
  • might know what validation is but don't necessarily understand it's importance or how/when it can be used
  • would suit grade 10 at school but other beginners in the general public and university
  • would suit classroom use or as extension work for school students

Features

Add in extra level of complexity with option of re-designing pages, not just cleaning up old tags and layout.  HTML5 validators don’t check for aesthetics.  Part A Will add redesign feature if there is time but is not part of our core concept of correcting archived content to current web standards. Likely we will not have time to implement this feature.
Add in a gallery of finished projects with a voting system Part A Gallery of finished projects added
(for all users to see).
Will add in voting if we have time to implement redesigning feature as well otherwise voting doesn't’ serve much purpose. Likely we will not have time to implement working gallery feature.
Separate profile setting and instruction page. Paper prototype Done.
Logo position and style not consistent across all page. Paper prototype Done, logo and header now consistent.

Landing/Home Page

Reduce the amount of text to explain concept Paper prototype Added an infographic/flowchart to explain concept and how you use site.
It should be more obvious whether you are singing up or login (make buttons more distinct from each other). Paper prototype Done with colours/CSS styling
Add explanation for difference between easy and hard mode.

Paper prototype Done on infographic.

Add in extra explanations/instructions for use. Paper prototype Will add more instructions on 'getting started page.
Make categories more obvious and easier to read. Paper prototype Done with CSS Styling. Have increased font size and made categories more obvious through use of colour.
Add in more categories Paper prototype If there is time. Likely we will not have time to implement this feature.

Editing page

Make it obvious what and how users are doing on this page.

Make errors easier to read
Paper prototype
/Digital prototype
Will display number of errors left to solve.
Have changed layout of page to reflect order of work (e.g. errors 1st, editor 2nd, "Save" and "Publish" 3rd)

Add small tutorial/instructions on how panels work/what you do on this page.

Will group errors together, add space between each error, numbering if possible.

Make sure "Publish" button saves as well Paper prototype Will be removing Publish button based on other feedback.  Users will get a 'winning' screen when all errors are solved that will allow them to publish.
Make navigation consistent across all pages (currently different on this page) Paper prototype Navigation/header has been updated on all pages to be the same.
Make layout of editor customisable. Paper prototype Will do if there's time.  This is high on the list of to-do features.
Suggested toggle box to make windows larger or smaller and continue to work in them or a pop-out system.
(relates to previous feedback)
Make code editing window larger.

(breaking up the errors into segments would also help with smaller code blocks).



Part B We will need to look into the current capabilities for adjusting the editors size as well as users ability to resize windows. (Changes to overall page width will need to be represented across the site).

ather than make panels movable, put content in tabs, either
errors thin at top, 2 tabs: html editor and css side by side; viewer, OR
separate html/css/viewer separate tabs and errors visible all the time
Add user name to work Paper prototype Has been implemented on gallery page
Let users know when they have solved errors. Paper prototype/ Part B Will add a 'congratulations' screen.
Remove publish button and allow users to publish privately or public gallery via win screen/pop-up.
Option to share success to social media if there is time.Likely we will not have time to implement this feature.
Add in a seperate box for CSS Paper prototype/
Digital prototype
Have done (but not currently fully functional).

Will make CSS save between modules.
Large amount of errors which load into the working panel. Hard to read/understand/manage (looks hard on easy level).
Suggestions:
  • order the errors by importance
    (must be fixed vs best practice)
  • break  rebuild into sections; could be a good way to tie in gamification
  • components would be a good way to work, encouraging users to encapsulate their code for each segment of a page.


Part B/
Digital prototype
Done See: Easy/hard has been changed to modules. 
HTML editor text is small for some users.  Many found side scroll annoying.  Digital prototype Let users use in-browser magnification to increase or decrease text size as needed.
Have changed scroll to text wrap in editors.
Users would like ability to upload own images to working panel

Digital prototype Will not have time to implement this feature

My Restorations

Make format similar to Gallery/Categories (i.e. tiles in a column/grid) Paper prototype Done
Change % progress bar to actual number of errors to make it more meaningful Paper prototype Done

Login

Would like log in to autofill after sign-up align font awesome icons Paper prototype Will do if there is time.

(Originally posted on our team blog: Restoring the web)

Week 11: Digital Prototype in class test

Here are the result of the Digital Protoype test session we ran in our contact session this week.  We aim to conduct the same test with real users in the next week.

Number of users: 5

Task 1: Login stress test and workflow test


  • Would like log in to autofill after sign-up
  • align font awesome icons

Task 2: Working panel and accessing help

Did you read the instructions on the home page?

  • no but prior knowledge of product x2
  • yes x2

Would you expect further instructions at this point?
  • as a dev, would rather play first
  • small tutorial maybe?
  • no
  • instructions didn’t cover working panel windows, this is what each bit is, need to understand layout

Do you know what to do on this page?
  • yes
  • where can i type?  looks a bit scary?


What would make the errors easier to read?
  • grouped together, space between each error, numbering would be good, bullet points, checkmarks
  • they are fine to read
  • multi-line erros, where does one error end and another start, gaps between each error, alternting line colours, wrap in container


If you didn't understand an error, where would you look for help?
  • google problem, not go to internal help
  • help should not be at the bottom
  • help should be modal or pop-out
  • difficult to see help button, add '?' help to error panel
  • put help with errors
  • google, stack overflow is industry standard on how to look for help


For each web page, there are multiple modules (e.g. Cricket Australia has 8 modules) that all pertain to the one page.  When you add CSS to the CSS editor and save, would you expect to see your saved CSS when you progress to the next module (i.e. Module 1 to Module 2)?
  • blank, prefer to start fresh each module
  • carry over if part of same website
  • frustrating to start over
  • would copy and paste if not automatic
  • yes, definetly

    Task 3: Use the working panel


    • would like ability to upload own images 
    • html editor text small x 2
    • html editor wrap text rather than scroll x2
    • rather than make panels movable, put content in tabs, either
      • errors thin at top, 2 tabs: html editor and css side by side; viewer, OR
      • separate html/css/viewer separate tabs and errors visible all the time


    (Originally posted on our team blog: Restoring the web)

    Week 11: Digital Protoype Test procedure

    This is the procedure we used in the digital protoyping session in class and will repeat with real users in the next week.  Sessions are run a one-on-one, in-situ interviews and usability tests.  Encourage users to talk aloud as they participate.  Remember - it is the system being tested, not the user.

    Pitch the concept:

    Explain concept but don't give any specific instructions on how to use site.

    Web standards are important to ensure that web pages display correctly in all browsers. Learning current web standards and how to comply with them are an essential part of learning how to write HTML and CSS. As web standards change over time, they depreciate old tags and introduce new tags and new features. One of the problems with archiving old websites (e.g. Trove, Pandora, Wayback Machine) is that even as web standards change, the archived websites still use the old, out-dated HTML tags.
    Web Historians provides HTML/CSS beginners with a practical, interactive web application to familiarise them with correct syntax and layout, the concept of web standards, the process of validating code against the latest standard, in context use of HTML and CSS, and basic editing.

    Task 1: Login stress test and workflow test

    Ask users to familiarise themselves with the home page (index.php) and when they are ready, sign up, log in, and log out.
    (tests the login system, workflow of log in/out and set-ups for the next task to see if the instructions/information on the home page are read)

    Task 2: Working panel and accessing help

    Ask users to log in with test account (tester/tester) and navigate to the test module for Cricket Australia. (tests navigation to working panel)

    Questions:

    • Did you read the instructions on the home page?
    • Would you expect further instructions at this point?
    • Do you know what to do on this page?
    • What would make the errors easier to read?
    • If you didn't understand an error, where would you look for help?
    • For each web page, there are multiple modules (e.g. Cricket Australia has 8 modules) that all pertain to the one page.  When you add CSS to the CSS editor and save, would you expect to see your saved CSS when you progress to the next module (i.e. Module 1 to Module 2)?

    Task 3: Use the working panel

    Ask users to have a play with the working panel, they can edit HTML, add CSS, and re-validate.  Ask if they have any comments or feedback.

    (Originally posted on our team blog: Restoring the web)

    Saturday, 10 October 2015

    Week 10: Modules

    This was a little more of the same.  Once I got the api/images/angular working for the sport category I then repeated the process for all the other categories, checking nothing broke as I copy-and-pasted code.  

    I also started into php for the first time for this project.  Lyndon had created log-in and sign-up pages in php and I edited them and styled them to look like the rest of our site.

    The other large change was to simplify the html content that users edit and validate.  Some of the feedback we had was that the errors panel was too complicated and the easy level wasn't that easy.  To counteract how complicated it is, we decided to break down each website into smaller modules.  I took our cricket website (which we seem to use as our test case for everything) and broke it down into 8 different modules.  I tried to pick obvious break points in the module and had to edit the code a little to make sure all tags in each module had both opened and closed.

    By changing the website into modules, we also had to change the easy/hard approach.  Instead of each website having easy or hard mode, now, depending on how modular each website is, it is now easy OR hard.  And we added more instructions to the website hover, 'begin restorations'.

    Sunday, 4 October 2015

    Mid-semester break: style updates and more angular

    I used the break to work on CSS/SASS and spend time with trove and the Wayback Time-machine.

    Styles

    • fixed some style inconsistencies with p and h styles
    • fixed the logotype: h1 size ration (logotype in now larger)
    • looked at the design of the page and changed from the 'indigo' colour palette to 'blackboard green' to match the infographic
    • crop the category image using CSS


    CSS Crop


    Page design



    Trove/Wayback machine

    My next task for the break was sourcing material for our site.  We had already decided on the four categories (sport, arts, education, government) and my task was to find approx 3 websites per category and source appropriate illustrative images from Trove, and web historical content from the Wayback Time-machine.  I search a combination of Pandora and Wayback Time-machine to find good examples of sites for each categories.  I concentrated on local sites (Brisbane, Queensland, Australia).

    Once I had selected the sites and made a list of the Wayback Machine addresses, I then went to Trove to find good search queries for each site.  Some were definitely easier than others.  I had AFL listed as one of the sport categories but was unable to find any images that were copyright free/retrievable with the Trove API.  I then proceeded to make the API calls, found the work IDs I needed, checked the calls work, and added the image URLs to an array to access for home.html.  

    Problems and solutions

    I used Plnkr to test adding real images to angular using a hard-coded array.  I then applied that to our real code but changed the hard coded array to the dynamic one constructed using API calls to Trove.

    The complicated part of using this array is the combination of Angular and Trove loading times.  The angular repeat happens much quicker than the Trove API calls.  Given that a lot of the information about the website (the link, website name, alt text, etc) the order of the images in the image array is important. The first step was then to direct each API call to a specific place in the array that corresponded to the data in the angular file.  

    e.g. imageArraySport[1]=olympicsImg;

    Where imageArraySport is the array to store the images for the sports tab and olympicsImg is the variable storing the image for the Sydney Olympics website.

    The next problem I had adding the images to the html generated by Angular.  I wrote a jQuery function that worked in plnkr that targeted a class and added the image source link from the links in the array.  This worked fine but wouldn't work when I used the real API calls instead of the hardcoded array.  I realised this was because the API calls came back at different times and when the function iterated over the array, it was not always full and returned a src link of nothing.

    To counteract this, I ran the function in each AJAX API calland added an if statement to check if the array had the number of images.

    e.g. if(imageArraySport.length == 3)

    Where the sport category has 3 websites and the if statement checks this first before running the rest of the function.