Changelog for API Docs

[Jay Lee]

Hey Guys,

  It'd be great if there was some sort of changelog for the API Documentation. Recently, a co-worker pointed out to me that you can now set start and end dates for vacation messages via the Email Settings API:

http://code.google.com/googleapps/domain/email_settings/developers_guide_protocol.html#GA_email_vacation_main

That functionality wasn't previously there but it got added without any blog post or update, one would have to be watching the docs very closely to notice the change. After that, I used changedetection.com to keep watch on the API Doc pages. There was a smaller (but still significant to me) update to the docs just today:

Both the Gmail delegator and the delegate: Must be active. A 500 error is returned if either user is suspended and disabled. Do not require a change of password in the next sign in. A 500 error is returned if either user has this flag enabled in the control panel, or, using the Provisioning API , the changePasswordAtNextLogin attribute is true .

not a major change but still would be nice to know about the update. Is there any way we could have a changelog for the API Docs for these minor updates?

Thanks!

Jay

[Andy "Rufus" Rothfusz]

Hi Jay,

That's a really good idea.  Implementing it might be slow going, but I'll see what we can do.  That changedetection site looks pretty cool.

We're constantly tweaking the documentation, often in response to questions asked here.  Most of the changes are clarifications of existing features, so they don't rate a blog post.  But you've definitely shown some good examples of when a simple change notification would help.

Jay's really one of the star contributors to these forums, so I'm sure he knows this already, but for those of you following along at home, here are the currently supported ways to get notified of changes:

1. The Google Apps Developer Blog: http://googleappsdeveloper.blogspot.com/  We try to announce new features here and any other cool tips and tricks.
2. Google Apps Downtime Notify: http://groups.google.com/group/google-apps-apis-downtime-notify This mailing list/group is where we let Google Apps developers know about any current problems with services.
3. Star an Issue: http://code.google.com/a/google.com/p/apps-api-issues/wiki/IssuesTab?tm=3  Apps-apis-issues issue tracker is where we track bugs in the APIs and where developers can report service interruptions.  When you find an issue that is the same as yours, you can click on the "star" to make it gold-colored, and then you will be notified of any changes to that issue.  When you see the issue status go from "New" to a number, then you know we are also tracking the issue internally at Google.  There is no automatic link between internal issues and external, so sometimes the problem will get fixed (or new feature added) days before we update apps-apis-issues, but eventually we will update the ticket and you'll know about the change.

I've added a new issue about this request for change notifications.  Please star it if you're interested in the feature.

http://code.google.com/a/google.com/p/apps-api-issues/issues/detail?id=2825

/Rufus

--
You received this message because you are subscribed to the Google Groups "Google Apps Domain Information and Management APIs" group.
To view this discussion on the web visit https://groups.google.com/d/msg/google-apps-mgmt-apis/-/1vNcjwiu24sJ.
To post to this group, send email to google-app...@googlegroups.com.
To unsubscribe from this group, send email to google-apps-mgmt...@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/google-apps-mgmt-apis?hl=en.

--
Andy "Rufus" Rothfusz | Developer Programs Engineer | Google | Mountain View, CA