enhance doc according to pr comments
enhance doc according to pr comments

aschnell/libstorage-bgl-eval,openSUSE/libstorage-bgl-eval,aschnell/libstorage-bgl-eval,openSUSE/libstorage-bgl-eval,aschnell/libstorage-bgl-eval,openSUSE/libstorage-bgl-eval,openSUSE/libstorage-bgl-eval,openSUSE/libstorage-bgl-eval,aschnell/libstorage-bgl-eval,aschnell/libstorage-bgl-eval