{"id":16458323,"url":"https://github.com/flexbox/teaching","last_synced_at":"2025-10-08T04:38:49.071Z","repository":{"id":151498709,"uuid":"43077256","full_name":"flexbox/teaching","owner":"flexbox","description":"Le Wagon guidelines for Teachers","archived":false,"fork":false,"pushed_at":"2015-09-29T15:29:47.000Z","size":405,"stargazers_count":0,"open_issues_count":0,"forks_count":15,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-10T03:19:10.449Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.lewagon.org","language":null,"has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flexbox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-09-24T15:58:37.000Z","updated_at":"2015-09-24T13:17:18.000Z","dependencies_parsed_at":"2023-04-08T20:54:32.065Z","dependency_job_id":null,"html_url":"https://github.com/flexbox/teaching","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexbox%2Fteaching","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexbox%2Fteaching/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexbox%2Fteaching/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flexbox%2Fteaching/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flexbox","download_url":"https://codeload.github.com/flexbox/teaching/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240980517,"owners_count":19888288,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-11T10:44:56.169Z","updated_at":"2025-10-08T04:38:44.044Z","avatar_url":"https://github.com/flexbox.png","language":null,"readme":"# Teaching @ Le Wagon\n\nHere is a list of guidelines you should follow during a workshop or a lecture.\n\n## Display\n\nThe closer your own setup is to the [standard student's one](https://github.com/lewagon/setup),\nthe better. That way you can share with them keyboard shortcuts. We use [Sublime Text 2](https://github.com/lewagon/setup).\n\nWhen you are video-projecting your screen, please follow these guidelines:\n\n- The only app running on your computer should be Finder, Sublime Text, Terminal and Browser\n- Have your text editor and terminal with a **light background**. You can install the [Solarized](http://ethanschoonover.com/solarized) theme, with the [Sublime Text package](https://github.com/braver/Solarized) and the [OSX terminal theme](https://github.com/tomislav/osx-terminal.app-colors-solarized)\n- Zoom a lot your font size (`⌘=`) in Sublime Text and your terminal.\n- If you don't have a lot of files, hide the folder drawer on the left with `⌘K, ⌘B`.\n- Switch from one file to the other with the `⌘P` (Command Palette)\n- You should use two windows layouts:\n  - Sublime Text in full screen\n  - Vertical split (50/50) with Sublime Text on the right, Terminal on the left\n\n![Split Layout](img/split_layout.png)\n\n## Tools\n\n### Gist\n\nAfter a long session of live-coding, usually students ask for the code. They like to keep it on their computer, for future's reference. A quick way to share some code files is to use [Github's gist service](http://gist.github.com/). A quicker way than copy/pasting manually every file is to install the [gist](https://github.com/defunkt/gist) gem on your computer:\n\n```bash\n$ brew install gist  # On ubuntu, you can `gem install gist`\n```\n\nThen, in an exercise folder, you can run:\n\n```bash\n$ gist -p *.rb\n```\n\nThis will automatically create a private gist with **all the ruby files** in the current folder. The program will give you the gist private URL that you can then share on Slack.\n\n\n### Floobits\n\nFloobits allow you to share you text editor with the students in their browser. This way, they have the code in front of their eyes, they can copy/paste it to their notes. If you have multiple files, they can browse them independently from you, which is very convinient in a Rails project with a lot of small files.\n\nYou can also use this tool in a live-code situation. The idea is that you can allow students to edit in their browser, and changes will be synced back to your own text editor, which is video-projected by the way :)\n\n#### Setup\n\n1. Go to [Floobits](https://floobits.com/signup) and sign up with GitHub, it's free\n1. Go to the *Settings* tab, you should find instructions to create your `~/.floorc.json` file\n1. Install the *Floobits* package using the Package Control in Sublime Text\n1. Install the binary [`flootty`](https://github.com/Floobits/flootty) with `pip install Flootty`\n\n#### Using Floobits in a lecture/workshop\n\nWhen doing a lecture, you should have prepare some live code examples to illustrate the slides. So basically, you `mkdir` a new folder, and `stt` into it. From Sublime Text, go to `Tools / Floobits / Share Directory (Public)`. This will give you an URL that you should share with students on Slack.\n\nWhen you create a new file and you want everybody to be on the page, you can right click in the file, and select `Floobits / Summon`.\n\nTo share your terminal session with the students, just run:\n\n```bash\n$ flootty\n```\n\nThe `-P` and `--unsafe` flags.\n\n#### Using Floobits in an interactive live-code\n\nIn a live-code, students stay at their seat. You can ask them to edit the code.\n\nAfter having shared a new workspace, you should go to `https://floobits.com/\u003cUSERNAME\u003e/\u003cWORKSPACE\u003e/permissions`. You should check the `Request Perms` option, and save.\n\nThat way, students will be able to hit `Collaborate / Request Permission to Edit` to edit the code.\n\n\n\n\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexbox%2Fteaching","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflexbox%2Fteaching","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflexbox%2Fteaching/lists"}