more fixes and improvements to linear systems docs