summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/README9
-rw-r--r--doc/TODO2
-rw-r--r--doc/openmicroblogging.txt (renamed from doc/openlisten.txt)35
3 files changed, 19 insertions, 27 deletions
diff --git a/doc/README b/doc/README
index 546e4320b..7bde30916 100644
--- a/doc/README
+++ b/doc/README
@@ -3,4 +3,11 @@ This package requires PHP 5.x and the following PHP Pear libraries:
- DB_DataObject
- Validate
- XMLWriter
-
+- Auth_Yadis from OpenIDEnabled (not the PEAR version!). I decided
+ to use the openidenabled.com version since it's more widely
+ implemented, seems to be better supported, and it may make sense to
+ use the openidenabled.com libraries for OpenID auth sometime in the
+ future. Note that this is no longer distributed separately; it's only
+ in the openidenabled.com OpenID PHP tarball.
+
+
diff --git a/doc/TODO b/doc/TODO
index 25f2731ed..c5f692b43 100644
--- a/doc/TODO
+++ b/doc/TODO
@@ -53,6 +53,8 @@
+ public stream link in top menu
+ dump, fix, undump database
+ release 0.2
+- YADIS document link on showstream
+- YADIS document
- subscribe remote
- add subscriber remote
- send remote notice
diff --git a/doc/openlisten.txt b/doc/openmicroblogging.txt
index b3208c24f..77c52a10f 100644
--- a/doc/openlisten.txt
+++ b/doc/openmicroblogging.txt
@@ -69,45 +69,28 @@ Discovery
The remote service recovers a YADIS document from the profile URL, as
described in YADIS 1.0.
-The remote service looks for a service of this type:
+The remote service looks for the URIs of Service of these types:
- http://openmicroblogging.org/protocol/0.1
-
-The service must include the following 5 URLs. [*]_
-
-omb:requestToken
+http://openmicroblogging.org/protocol/0.1/requestToken
Request Token URL, as in OAuth 1.0
-omb:userAuthorization
+http://openmicroblogging.org/protocol/0.1/userAuthorization
User Authorization URL, as in OAuth 1.0
-omb:accessToken
+http://openmicroblogging.org/protocol/0.1/accessToken
Access Token URL, as in OAuth 1.0
-omb:postNotice
+http://openmicroblogging.org/protocol/0.1/postNotice
Post Notice URL, as defined below.
-omb:updateProfile
+http://openmicroblogging.org/protocol/0.1/updateProfile
Update Profile URL, as defined below.
-It must also include the following URI:
-
-omb:identifier
+http://openmicroblogging.org/protocol/0.1/identifier
identifier URI for the user with this profile URL.
-
-Here, omb: is the namespace prefix for:
-
- http://openmicroblogging.org/xmlns/0.1
-
-The YADIS URI defined for the service can be ignored.
-.. [*] I decided to use a separate namespace with 5 elements to enable
- having different providers for general OAuth and specific OµB. A
- future version of this document may have a mode that allows a
- single URL defined in the <URI> element with an additional URL
- parameter like 'action=requesttoken', 'action=userauthorization' or
- something similar. But that simplifies the YADIS doc at the expense
- of the rest of the protocol.
+If any of the URIs is unavailable, the remote service MUST stop
+processing.
Authorization
=============