document sellable

Also fix syntax errors in the documentation.

Change-Id: Iaf2c55376752d2eb323061d42458ed4eb3b8b942