more improvements on the solution one docs