Improved features list

Author: Bernardo-MG

README.rst

@@ -28,10 +28,9 @@ operating with it on any Python application.
 Features
 --------
 
-The library contains the following features:
-
-- API for dice and dice notation, along classes to generate values from them
-- Parser to create API instances from the notation
+- Ply-based parser to generate objects for dice notation
+- Easy-to-use objects to handle the notation, just call the 'roll' method
+- Classes to support plain dice
 
 Documentation
 -------------
@@ -80,14 +79,14 @@ the following command:
 Usage
 -----
 
-The application has been coded in Python, without using any particular
+The application has been coded in Python, and does not require any particular
 framework.
 
 To use it just import the parser:
 
     >>> from dice_notation.parser import DiceParser
 
-And then use it to parser a dice notation expression:
+And then use it to parse a dice notation expression:
 
     >>> parser = DiceParser()
     >>> dice = parser.parse('1d6+2')

docs/source/index.rst

@@ -2,16 +2,20 @@
 Dice Notation Tools for Python
 ==============================
 
-This is the documentation for a Python library. Change all the placeholder
-texts with actual information.
+Created on the late 70s for Dungeons & Dragons, the tabletop notation has
+become a standard on tabletop games, defining formulas used to generate random
+values with the help of dice.
+
+These are very simple: 2d6+5 means “roll two dice, add their values and then
+add the number five to the result”.
 
 --------
 Features
 --------
 
-- A feature
-- Another feature
-- A third feature
+- Ply-based parser to generate objects for dice notation
+- Easy-to-use objects to handle the notation, just call the 'roll' method
+- Classes to support plain dice
 
 .. toctree::
    :hidden: