Move docs to Markdown and use markdown renderer in server.

1 files changed, 80 insertions, 0 deletions

diff --git a/docs/tips.md b/docs/tips.md
new file mode 100644
index 0000000..c0a71c7
--- /dev/null
+++ b/docs/tips.md
@@ -0,0 +1,80 @@
+<style>
+img { height: 18px; vertical-align: -3px; }
+</style>
+
+# Tips & Tricks
+
+## Shortcuts
+
+There are several ways to scroll without the scroll bars:
+
+* The <kbd>&#x2190;</kbd> <kbd>&#x2191;</kbd> <kbd>&#x2193;</kbd> <kbd>&#x2192;</kbd> keys.
+* <kbd>Shift</kbd> + <kbd>mouse wheel</kbd> to scroll horizontally.
+* Hold down the middle mouse button and drag.
+* Two finger scrolling with the touch pad.
+* Tap and drag using a touch screen.
+
+There are also several ways to change the size of the game area:
+
+* <kbd>Control</kbd> + <kbd>+</kbd> to zoom in.
+* <kbd>Control</kbd> + <kbd>-</kbd> to zoom out.
+* <kbd>Control</kbd> + <kbd>0</kbd> to reset zoom.
+* <kbd>Control</kbd> + <kbd>mouse wheel</kbd> to zoom in and out.
+* Pinch gesture with a touchpad.
+* Pinch gesture on a touch screen.
+
+Hold down the <kbd>Shift</kbd> key to see more information.
+In some games cards and chits will be magnified when mousing over them when holding shift.
+Other games may reveal the reverse side of pieces.
+
+Open a separate browser tab or window for each side when playing solo.
+
+
+## Toolbar
+
+The ![cog](/images/cog.svg) menu has links to rules, player aids and other reference material.
+In some games you can also choose between alternative graphics and layout options.
+The resign option is also present here if available.
+
+The ![scroll](/images/scroll-quill.svg) button toggles the game log and player status displays.
+
+The ![magnifying-glass](/images/magnifying-glass.svg) button shrinks the map to fit your screen.
+
+The ![chat-bubble](/images/chat-bubble.svg) button lights up if you have unread chat messages.
+Chat messages can only be seen by players who have joined the game.
+Use <kbd>Enter</kbd> and <kbd>Escape</kbd> to quickly open and close the chat box.
+
+The ![recycle](/images/cycle.svg) button appears when the game is over.
+Use this to quickly start a rematch with the same players, or to go to the tournament score page.
+
+The ![globe](/images/earth-africa-europe.svg) button hides all counters and markers.
+Use this if you need to check something on the map that is obscured.
+
+
+## Time Control
+
+For everyone's enjoyment, please respect the pace requests!
+If someone wants a fast game, don't join if you can only play one move per day.
+
+Each player has a clock that ticks down while it's their turn.
+When the clock runs out, they forfeit the game.
+Each time a player takes a move, they get some time back on the clock, but there's a limit to how
+much time you can accumulate.
+
+<dl>
+<dt> No time control
+<dd> For friendly games without an enforced pace.
+<dt> Live / Blitz (7+ moves per day)
+<dd> 24h +4h/move up to 72h
+<dt> Fast (3+ moves per day)
+<dd> 72h +12h/move up to 120h
+<dt> Slow (1+ move per day)
+<dd> 72h +36h/move up to 240h
+</dl>
+
+When playing live, let your opponents know if you're going away!
+If you need to resume a live game another day, schedule a time when you can continue.
+
+Turn on notifications so you can take your turns promptly.
+If you see that your opponent is online (the dot next to their name is filled in)
+then stay in the game for a while and perhaps you can play live for a bit.