yahoo-eng-team team mailing list archive

[Steve Martinelli <stevemar@xxxxxxxxxx>]

Public bug reported:

I noticed a few spots in the docs that are out of date, I'm going to
list them all here, some might not be necessary.

1) Mention that ADMIN_TOKEN does not carry any authorization (we say
this in sample.conf)
http://docs.openstack.org/developer/keystone/configuringservices.html
#admin-token

2) Tenant is used:
http://docs.openstack.org/developer/keystone/configuringservices.html
#setting-up-tenants-users-and-roles

3) Tenant again:
http://docs.openstack.org/developer/keystone/configuringservices.html
#creating-service-users

4) Should we mention #openstack-keystone: http://docs-
draft.openstack.org/00/73900/4/check/gate-keystone-
docs/98c168c/doc/build/html/community.html#openstack-on-freenode-irc-
network

5) This seems like a good spot to mention extensions, since they are not
really mentioned anywhere (except developing extensions):
http://docs.openstack.org/developer/keystone/architecture.html

6) Can we condense Service API Examples Using Curl and Admin API
Examples Using Curl, as they go to the same url:
http://docs.openstack.org/developer/keystone/#developers-documentation

7) This contains a lot of V2 specific content: http://docs.openstack.org/developer/keystone/api_curl_examples.html (tenant is used, /tokens instead of /auth/tokens, token response contains 'access'.
Not sure if we should keep two copies, or update it all to v3.

8) No mention of disable events in:
http://docs.openstack.org/developer/keystone/event_notifications.html

** Affects: keystone
     Importance: Undecided
         Status: New

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

Title:
  Update keystone docs for IceHouse release

Status in OpenStack Identity (Keystone):
  New

Bug description:
  I noticed a few spots in the docs that are out of date, I'm going to
  list them all here, some might not be necessary.

  1) Mention that ADMIN_TOKEN does not carry any authorization (we say
  this in sample.conf)
  http://docs.openstack.org/developer/keystone/configuringservices.html
  #admin-token

  2) Tenant is used:
  http://docs.openstack.org/developer/keystone/configuringservices.html
  #setting-up-tenants-users-and-roles

  3) Tenant again:
  http://docs.openstack.org/developer/keystone/configuringservices.html
  #creating-service-users

  4) Should we mention #openstack-keystone: http://docs-
  draft.openstack.org/00/73900/4/check/gate-keystone-
  docs/98c168c/doc/build/html/community.html#openstack-on-freenode-irc-
  network

  5) This seems like a good spot to mention extensions, since they are
  not really mentioned anywhere (except developing extensions):
  http://docs.openstack.org/developer/keystone/architecture.html

  6) Can we condense Service API Examples Using Curl and Admin API
  Examples Using Curl, as they go to the same url:
  http://docs.openstack.org/developer/keystone/#developers-documentation

  7) This contains a lot of V2 specific content: http://docs.openstack.org/developer/keystone/api_curl_examples.html (tenant is used, /tokens instead of /auth/tokens, token response contains 'access'.
  Not sure if we should keep two copies, or update it all to v3.

  8) No mention of disable events in:
  http://docs.openstack.org/developer/keystone/event_notifications.html

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