While I am all for transparency, introducing a burden on Kevin's time to announce every modification would severely affect the time to market for the beta.

I am parsing the API several times a day and the changes are fairly fast and furious. 

I will write a schema comparer that will emit a change list, create a Q here and keep it current. 

It may take a few days.

---
**Update**:

I have rewritten the api parser which will now output an xml document containing each route, it's parameters and return type.

Now I will write a comparer that will flag new/changed routes/types/enum etc.

---

Here is a sample .ToString() of the api definition. I have ommitted the return type due to size constraints.

I will make an announcement of a **[SOAPIWATCH][1]** service that will notify subscribers when the API changes and provide a nicely presented diff. The audience for this will likely be we developers.


<pre>
SOAPI - Version 0.8 Revision 2010.6.4.1

Types:
  Seen Types:
    128-bit floating point, IEEE 754
    32-bit signed integer
    boolean
    guid, 8-4-4-4-12 format
    number
    one of active (default), votes, creation, featured, hot, week, or month
    one of activity (default), views, creation, added, or votes
    one of activity (default), views, creation, or votes
    one of anonymous, unregistered, registered, or moderator
    one of comment, askoranswered, badge, revision, or accepted
    one of creation (default), or votes
    one of desc (default), or asc
    one of popular (default), activity, or name
    one of question, answer, comment, revision, or votes
    one of question, or answer
    one of reputation (default), creation, or name
    one of single_user, or vote_based
    string
    unix epoch date, range [0, 253,402,300,799]

  Unknown Types:
    

Routes:
  /answers/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /answers/{id}/comments
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /badges
  ------------------------------------------
    Parameters:
    ----------------------------------------


  /badges/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /badges/name
  ------------------------------------------
    Parameters:
    ----------------------------------------


  /badges/tags
  ------------------------------------------
    Parameters:
    ----------------------------------------


  /comments/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /errors/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    id (32-bit signed integer)


  /posts/{id}/comments
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of active (default), votes, creation, featured, hot, week, or month)
    tagged (optional) (string)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/{id}/answers
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/{id}/comments
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/{id}/timeline
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/tagged/{tags}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of active (default), votes, creation, featured, hot, week, or month)
    tags (string)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /questions/unanswered
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    tagged (optional) (string)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /revisions/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /revisions/{id}/{revisionguid}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    revisionguid (guid, 8-4-4-4-12 format)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /search
  ------------------------------------------
    Parameters:
    ----------------------------------------
    intitle (optional) (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    nottagged (optional) (string)
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    tagged (optional) (string)


  /stats
  ------------------------------------------
    Parameters:
    ----------------------------------------


  /tags
  ------------------------------------------
    Parameters:
    ----------------------------------------
    filter (optional) (string)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    max (optional) (string)
    min (optional) (string)
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of popular (default), activity, or name)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users
  ------------------------------------------
    Parameters:
    ----------------------------------------
    filter (optional) (string)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (optional) (string)
    max (optional) (string)
    min (optional) (string)
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of reputation (default), creation, or name)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (string)
    min (optional) (string)
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of reputation (default), creation, or name)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/answers
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/badges
  ------------------------------------------
    Parameters:
    ----------------------------------------
    id (string)


  /users/{id}/comments
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/comments/{toid}
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])
    toid (32-bit signed integer)


  /users/{id}/favorites
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, added, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/mentioned
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of creation (default), or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/questions
  ------------------------------------------
    Parameters:
    ----------------------------------------
    body (optional) (boolean)
    comments (optional) (boolean)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (unix epoch date, range [0, 253,402,300,799])
    min (optional) (unix epoch date, range [0, 253,402,300,799])
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of activity (default), views, creation, or votes)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/reputation
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/tags
  ------------------------------------------
    Parameters:
    ----------------------------------------
    filter (optional) (string)
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    max (optional) (string)
    min (optional) (string)
    order (optional) (one of desc (default), or asc)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    sort (optional) (one of popular (default), activity, or name)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])


  /users/{id}/timeline
  ------------------------------------------
    Parameters:
    ----------------------------------------
    fromdate (optional) (unix epoch date, range [0, 253,402,300,799])
    id (string)
    page (optional) (32-bit signed integer)
    pagesize (optional) (32-bit signed integer)
    todate (optional) (unix epoch date, range [0, 253,402,300,799])



</pre>


  [1]: https://stackapps.com/questions/534/soapi-watch-a-realtime-service-that-notifies-subscribers-via-email-twitter-etc