[MRG+1] Inconsistencies for the kernel documentation #2901 

Documentation improvements. Contributions made in the context of the Bloomberg Open Source Day. 
Should this be degree=1?