+some fixes during doc writing