yahoo-eng-team team mailing list archive

[Chris Johnson <wchrisjohnson@xxxxxxxxx>]

Public bug reported:

The external docs for the "Authenticates and generates a token" API call
in Keystone v3 are a mess, specifically related to how they lay out the
various requests and their associated responses. There are many ways
that a token can be generated (8 as far as the existing docs reflect),
and there is no indication given to the application developer that if
they submit a token request with a request body of X, they will receive
a response that looks like Y. This seems to be an obvious way to lay out
the possible request/response options.

** Affects: keystone
     Importance: Undecided
     Assignee: Chris Johnson (wchrisjohnson)
         Status: New


** Tags: documentation

** Changed in: keystone
     Assignee: (unassigned) => Chris Johnson (wchrisjohnson)

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

Title:
  Refactor "Authenticates and generates a token" docs for Keystone v3

Status in OpenStack Identity (Keystone):
  New

Bug description:
  The external docs for the "Authenticates and generates a token" API
  call in Keystone v3 are a mess, specifically related to how they lay
  out the various requests and their associated responses. There are
  many ways that a token can be generated (8 as far as the existing docs
  reflect), and there is no indication given to the application
  developer that if they submit a token request with a request body of
  X, they will receive a response that looks like Y. This seems to be an
  obvious way to lay out the possible request/response options.

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