1

This is probably just a simple documentation fix and not really a bug. The doc for the /questions/{id}/timeline method says that the user and owner objects are not optional, but they aren't always present in the results.

Example: http://api.stackoverflow.com/0.8/questions/2938604/timeline

API Help: http://api.stackoverflow.com/0.8/help/method?method=questions/{id}/timeline

2

Technically that's incorrect.

The help docs say nothing about the required/optional nature of user and owner, only whether certain of their subfields are required should they be present. This is a gap in our automagic doc generation system which will - eventually - be fixed.

When it is, user and owner will be marked "optional."

3
  • D'oh! You're right. My eye skipped into the user_id field because I was only looking for one specific attribute. Thanks for the clarification. May 30 '10 at 22:26
  • Did you really make an "automagic" doc generation system? Neat! May 30 '10 at 23:23
  • 1
    @George - the majority of the /help information is generated in code. We did this so its harder (though, obviously not impossible) for the docs and the code to get out of sync. May 30 '10 at 23:29

You must log in to answer this question.

Not the answer you're looking for? Browse other questions tagged .