UP | HOME

Collaboration

Table of Contents

1-on-1 research discussions work well for me. Explaining ideas and confusions to each other generates insight.

It also makes me very productive.

It's very important that I use a whiteboard to communicate my thinking. I have a camera specifically to film my whiteboard. Anecdote: I completely fail to explain 4 times in language. I write it on a whiteboard and I communicate successfully first try.

Here is a recording of a research discussion.

During the meetings, notes are taken. Sometimes I refine these notes.

Sometimes we code (in Clojure).

Roughly:

  1. Figure out things on a whiteboard.
  2. Capture important insights in writing.
  3. Implement ideas in code.

1. Live Share Documents 🔗

1.1. Setup for Host 🔗

This is only for hosting a collaborative session, and not needed for connecting to one.

Install tmux and put the following tmux configuration (on linux put in ~/.tmux.conf): 

set -g default-terminal "$TERM" 
set-option -sa terminal-overrides ",$TERM:Tc"
set-option -g mouse on

1.2. Setup for Clients 🔗

Ensure that your terminal emulator supports truecolor, and doesn't clobber keys you want to use in emacs.

I recommend to install the kitty terminal emulator and use the following configuration (on linux put in ~/.config/kitty/kitty.conf): 

clear_all_shortcuts yes
cursor_blink_interval 0

1.3. Connection sequence for clients 🔗

Each time you want to join a session you need to:

  1. Log into the right machine with ssh with your truecolor terminal emulator. Run ssh USER@DOMAIN, e.g. ssh ben@my-website.com.
  2. Run tmux
  3. Run emacsclient-truecolor-term (which is just TERM=xterm-direct emacsclient -nw).