Remove "willRenderTimeline()" from ApplicationTransactionInterface

Authored by epriestley on Wed, Dec 19, 7:52 PM.


Remove "willRenderTimeline()" from ApplicationTransactionInterface

Depends on D19914. Ref T11351. Some of the Phoilo rabbit holes go very deep.

PhabricatorApplicationTransactionInterface currently requires you to implement willRenderTimeline(). Almost every object just implements this as return $timeline; only Pholio, Diffusion, and Differential specialize it. In all cases, they are specializing it mostly to render inline comments.

The actual implementations are a bit of a weird mess and the way the data is threaded through the call stack is weird and not very modern.

Try to clean this up:

  • Stop requiring willRenderTimeline() to be implemented.
  • Stop requiring getApplicationTransactionViewObject() to be implemented (only the three above, plus Legalpad, implement this, and Legalpad's implementation is a no-op). These two methods are inherently pretty coupled for almost any reasonable thing you might want to do with the timeline.
  • Simplify the handling of "renderdata" and call it "View Data". This is additional information about the current view of the transaction timeline that is required to render it correctly. This is only used in Differential, to decide if we can link an inline comment to an anchor on the same page or should link it to another page. We could perhaps do this on the client instead, but having this data doesn't seem inherently bad to me.
  • If objects want to customize timeline rendering, they now implement PhabricatorTimelineInterface and provide a TimelineEngine which gets a nice formal stack.

This leaves a lot of empty willRenderTimeline() implementations hanging around. I'll remove these in the next change, it's just going to be deleting a couple dozen copies of an identical empty method implementation.

Test Plan:

  • Viewed audits, revisions, and mocks with inline comments.
  • Used "Show Older" to page a revision back in history (this is relevant for "View Data").
  • Grepped for symbols: willRenderTimeline, getApplicationTransactionViewObject, Legalpad classes.

Reviewers: amckinley

Reviewed By: amckinley

Maniphest Tasks: T11351

Differential Revision: https://secure.phabricator.com/D19918