Document current_user_id in a release note

Also fix the connect_as docstring.

Change-Id: I53203b892bcf03d540d6e551ec9615439ad5c4c9

openstack/cloud/openstackcloud.py

@@ -398,7 +398,7 @@ class OpenStackCloud(_normalize.Normalizer):
           cloud = shade.openstack_cloud(cloud='example')
           # Work normally
           servers = cloud.list_servers()
-          cloud2 = cloud.connect_as(dict(name='different-project'))
+          cloud2 = cloud.connect_as_project('different-project')
           # Work in different-project
           servers = cloud2.list_servers()
 

releasenotes/notes/add-current-user-id-49b6463e6bcc3b31.yaml

@@ -0,0 +1,4 @@
+---
+features:
+  - Added a new property, 'current_user_id' which contains
+    the id of the currently authenticated user from the token.