Improved warning descr and fixed docs header