improve inline and offline documentation