Public bug reported:

The user guide and admin guide need info about the secure "multihash"
feature.  Both need to describe the idea of the self-describing secure
hash.  Additionally:

admin guide: the os_hash_algo is operator-configurable; explain how

user guide: the os_hash_algo value can be passed to hashlib to obtain a
digest algorithm to validate a download

Current sources for this info are:
(1) description of os_hash_value, os_hash_algo in the api-ref
(2) the multihash spec: 
https://specs.openstack.org/openstack/glance-specs/specs/rocky/implemented/glance/multihash.html
(3) rocky release notes: 
https://docs.openstack.org/releasenotes/glance/rocky.html

** Affects: glance
     Importance: Undecided
         Status: Triaged


** Tags: docs documentation low-hanging-fruit

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Glance.
https://bugs.launchpad.net/bugs/1871419

Title:
  need multihash info in  glance user, admin guides

Status in Glance:
  Triaged

Bug description:
  The user guide and admin guide need info about the secure "multihash"
  feature.  Both need to describe the idea of the self-describing secure
  hash.  Additionally:

  admin guide: the os_hash_algo is operator-configurable; explain how

  user guide: the os_hash_algo value can be passed to hashlib to obtain
  a digest algorithm to validate a download

  Current sources for this info are:
  (1) description of os_hash_value, os_hash_algo in the api-ref
  (2) the multihash spec: 
https://specs.openstack.org/openstack/glance-specs/specs/rocky/implemented/glance/multihash.html
  (3) rocky release notes: 
https://docs.openstack.org/releasenotes/glance/rocky.html

To manage notifications about this bug go to:
https://bugs.launchpad.net/glance/+bug/1871419/+subscriptions

-- 
Mailing list: https://launchpad.net/~yahoo-eng-team
Post to     : yahoo-eng-team@lists.launchpad.net
Unsubscribe : https://launchpad.net/~yahoo-eng-team
More help   : https://help.launchpad.net/ListHelp

Reply via email to