Ceph

The docs for keystone integration [1] are outdated and only show commands for the deprecated v2 identity API. For example with API v3 this command would fail:

openstack endpoint create --region RegionOne \
     --publicurl   "http://radosgw.example.com:8080/swift/v1" \
     --adminurl    "http://radosgw.example.com:8080/swift/v1" \
     --internalurl "http://radosgw.example.com:8080/swift/v1" \
     swift
usage: openstack endpoint create [-h] [-f {json,shell,table,value,yaml}]
                                 [-c COLUMN] [--noindent] [--prefix PREFIX]
                                 [--max-width <integer>] [--fit-width]
                                 [--print-empty] [--region <region-id>]
                                 [--enable | --disable]
                                 <service> <interface> <url>
openstack endpoint create: error: argument <interface>: invalid choice: '
http://radosgw.example.com:8080/swift/v1' (choose from 'admin', 'public', 'internal')

Instead each endpoint should be created seperately for every interface, e.g.:

openstack endpoint create --region RegionOne public "http://radosgw.example.com:8080/swift/v1" 
openstack endpoint create --region RegionOne admin "http://radosgw.example.com:8080/swift/v1" 
openstack endpoint create --region RegionOne internal "http://radosgw.example.com:8080/swift/v1" 

Maybe the v2 variant can stay in the docs but it should be clarified that the commands vary between the API versions.

Just a note on the button "Report Documentation Bugs" [2] on the top of the page: I was confused about its content and decided to report a bug here instead. I don't know if that's by design but I don't understand what to do there.

[1] https://docs.ceph.com/en/latest/radosgw/keystone/
[2] https://pad.ceph.com/p/Report_Documentation_Bugs