+def puzzle_channel_description(puzzle):
+ """Compute the channel description for a puzzle"""
+
+ url = puzzle.get('url', None)
+ sheet_url = puzzle.get('sheet_url', None)
+ tags = puzzle.get('tags', [])
+ state = puzzle.get('state', None)
+
+ description = (
+ "Discussion to solve the puzzle \"{}\".\n".format(puzzle['name'])
+ )
+
+ if url:
+ description += "See the <{}|Original puzzle>\n".format(url)
+
+ if sheet_url:
+ description += (
+ "Actual solving work takes place in the "
+ + "<{}|shared spreadsheet>\n".format(sheet_url)
+ )
+
+ if tags:
+ description += "This puzzle has the following tags: {}\n".format(
+ " ".join(["`{}`".format(t) for t in tags]))
+
+ if state:
+ description += "This puzzle has a state of: {}\n".format(state)
+
+ description += (
+ "You can see a summary of this information at any point "
+ + "by issuing the `/puzzle` command and you can edit any of "
+ + "this information by issuing the `/edit` command"
+ )
+
+ return description
+