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

Documentation improvements. Contributions made in the context of the Bloomberg Open Source Day. 
This now seems like a duplication of what is in the SVM docs, right?