Week 1 - Principles and Practice / Project Management#
- Authors:
Rico Kanthatham
,Kai Naito
,Georg Tremmel
- Created:
1/30/2020
, Last Updated:1/11/2023
Agenda#
Local Session Preparation Session: Every Thursday, 20:00pm - 22:00pm
Assignments#
- Copy and paste “Student Agreement” and save as “agreement.md” into your local repository folder. Read and fully understand the content of the agreement then sign your name to acknowledge that you agree. It is very highly recommended that you read the Instructor’s Agreement and the Fablab Agreement as well…so that you are aware of their responsibilities to you.
- Plan and sketch a potential Final Project concept
- Complete a Git Tutorial
- Build a personal Fab Academy website in the class archives…describing yourself and your final project
Goals#
- Learn Git “Version Control”
- Learn Markdown HTML script generation
- Learn effective Fab Academy “Documentation” techniques
- Learn Fab Academy Assessment (Nueval)
- Learn “Project Management” techniques
Support documents#
- Introduction to FabAcademy
- Version Control Overview
- Documentation Techniques & Tips
- Documentation Organization & Template - Recommendation
- Documentation Template - Example
- Project Management Techniques & Tips
- Cheat Sheets for MkDocs
- Git Tutorial (日本語)
Advices from Instructors#
- Try some different text editors: テキストエディタはクラスで紹介されたものの中からいくつか使ってみて、自分に合うものを探すと良いです。Suggestions (2023):
VSCode
,TextMate
,BBEdit
, if you want to go terminal only, tryvi
,emacs
ornano
. - Copy other former student’s website and build yours upon it : トライしたい人は、過去の受講生のサイトからソースコードをコピーして自分のサイトに仕立ててみるとHTMLの勉強になります。Or try any of the site generators, included with the GitLab FabCloud.
- おすすめツール:Google Chrome developer tools
- Create a weekly Fab Academy work schedule for yourself…to fit your own personal situation.
Class review#
1.27.2021 Global Session Notes
1.25.2023 Global Session Notes
Tutorials#
- Tutorial : Setting-up git and upload your repo
- Tutorial : Gitの設定からリポジトリのアップロードまで(上サイト日本語訳)
- Setting up Mkdocs MkdocsというStatic site generatorを使って、サイトをデプロイする。
- Git tutorial クラスで言及があったチュートリアルです。Gitのコマンドやワークフローをカバーしてますので、目を通してください。
Announcements / Notes#
File upload guidelines#
Maximum push (upload) size 10MB Maximum Cloud Repository size 100MB (for the entire Fab Academy course)
- Image Files: save them into the local repository (each image should be approximately 150kb in size…downsizing of images will likely be required…use a batch image processing software such as XnConvert)
- Video Files: upload to Youtube, Vimeo etc. and embed the links in your markdown document
- Other files: save them into local repository
Gitlab Tips#
- **Issue tracker:**授業に関するお知らせがポストされる > FabAcademy 2023 site
- Set Global notification setting to “Watch”
- You can post questions relevant to all members of Fab Academy in Gitlab using the Issue Tracker
Recitation: Version Control#
- Monday, January 30th, 23:00pm JST