doc: some improvements