Add some more docstrings

Author: scl-softwire

chessington/engine/board.py

@@ -25,6 +25,9 @@ class Square(namedtuple('Square', 'row col')):
 
     @staticmethod
     def at(row, col):
+        """
+        Creates a square at the given row and column.
+        """
         return Square(row=row, col=col)
 
 
@@ -55,19 +58,31 @@ def _create_starting_board():
         return board
 
     def set_piece(self, square, piece):
+        """
+        Places the piece at the given position on the board.
+        """
         self.board[square.row][square.col] = piece
 
     def get_piece(self, square):
+        """
+        Retrieves the piece from the given square of the board.
+        """
         return self.board[square.row][square.col]
 
     def find_piece(self, piece_to_find):
+        """
+        Searches for the given piece on the board and returns its square.
+        """
         for row in range(BOARD_SIZE):
             for col in range(BOARD_SIZE):
                 if self.board[row][col] is piece_to_find:
                     return Square.at(row, col)
         raise Exception('The supplied piece is not on the board')
 
     def move_piece(self, from_square, to_square):
+        """
+        Moves the piece from the given starting square to the given destination square.
+        """
         moving_piece = self.get_piece(from_square)
         if moving_piece is not None and moving_piece.player == self.current_player:
             self.set_piece(to_square, moving_piece)

chessington/engine/pieces.py

@@ -14,12 +14,11 @@ def __init__(self, player):
 
     @abstractmethod
     def get_available_moves(self, board):
+        """
+        Get all squares that the piece is allowed to move to.
+        """
         pass
 
-    def move_to(self, board, new_square):
-        current_square = board.find_piece(self)
-        board.move_piece(current_square, new_square)
-
 
 class Pawn(Piece):
     """