Week 1

Jan 25: Principles and Practices, Project Management

Assignments:

  • plan and sketch a potential final project
  • work through a Git tutorial
  • build a personal site in the class archive describing you and your final project
  • Final Project Planning

    My final project has to be connected to my current PhD studies. My PhD research focuses on applying Persuasive Systems Design and Sustainable/Green Information Systems and Technologies. I am considering making a device that helps reducing water consumption at home, most likely some sort of a shower timer. I will be adding more specifications about the final project development on the page dedicated to it, as I learn relevant skills in the weekly lectures.

    Not sure what the actual final design will be

    Git and Project Management

    To kick off, I registered at https://www.fablabs.io/. With these credentials, I logged in to http://git.fabacademy.org/

    In my projects, I found "fabacademy2017/fablaboulu"

    I downloaded git-2.10.1-intel-universal-mavericks from https://git-scm.com/ and installed it. Opening Git on OS X, requires opening Applications folder, then the Utilities folder, then the Terminal application.

    Next step is generating a SSH key

    ssh-keygen -t rsa -C "youremailaddress"

    The key needs to be copied and pasted in the GitLab. To copy the key

    pbcopy < ~/.ssh/id_rsa.pub

    The key is then pasted in GitLab at

    Your Profile > Profile Settings > SSH Keys > Add an SSH key > Key > Add key

    The address of the local git directory (git@git.fabacademy.org:fabacademy2017/fablaboulu.git) to be used with the git clone command in the next step is found at

    Projects > Your projects > fabacademy2017 / fablaboulu

    After that I tested whether I can clone, pull, push and commit files to the local repository. Commands used

  • git clone - Clone a repository into a new directory
  • git status - Show the working tree status
  • git pull - Fetch from and integrate with another repository or a local branch
  • git add . - Add file contents to the index
  • git commit - Record changes to the repository
  • git push origin master- Update remote refs along with associated objects
  • Find detailed descriptions of the commands at https://git-scm.com/docs

    Building the Website

    To create a website, first, I reviewed www.w3schools.com to refresh my web development skills. Next, I installed the text editor, convenied for writing code. As adviced by Fab Lab Oulu's manager, Jani Ylioja, I decided to try Brackets, which I had not used before. I had previously used Notepad++ and Sublime Text for the source code editing.

    For my website, I used a template I found at https://startbootstrap.com/. Searching for the template, I also noted that http://getbootstrap.com/ provides a good range of resources which I may be using.

    To get started with documenting, I reviewed pages of the Fab Academy 2016 Oulu graduates. Dorina Rajanen's page provided an excellent example of documenting assignments and helped with completing this week's task.

    I started with making a few pages to structure the website


    • index.html
    • - a simple home page
    • post.html
    • - a timeline with links to the weekly assignments
    • about.html
    • - a short description about me
    • contact.html
    • - a page with the contact information
    • week1.html
    • - this page, the first weekly assignment page which will be a sample for all the upcoming ones.

    Coding the Home page

    The clean-blob.min.css file describes how the HTML elements will be displayed on the website.


    Note: Brackets formats the text according to the extension of the file. This setting is displayed in the bottom of the window.

    The contact page initially included a contact form which I decided not to use so I commented it out.

    On the bottom of all pages, I included links to my email and LinkedIn profile. I also acknowledged that this website is licenced under the Creative Commons Attribution 4.0 International License. I used this page https://creativecommons.org/choose/ to generate the HTML code to paste on my pages. More information about the Licence Deed is here https://creativecommons.org/licenses/by/4.0/ and abot the Legal Code is here https://creativecommons.org/licenses/by/4.0/legalcode .

    To organize media in my student folder in the repository, I created folders img and files, in which I will be adding subfolders for each week's images and files used on the website pages.

    Remember, remember...

  • Check files' sizes prior to pushing them to the repo...No recognition to be received form the Fab Lab community for commiting excessive MBs;
  • Better not use a complex template for your website, it is likely that fairly quickly it'll occur to you that it's not the best idea...