Page MenuHomePhabricator

Write documentation for Excimer
Closed, ResolvedPublic


  • On-wiki documentation, probably at Can probably refer to the docbook or doxygen documentation for most details.
  • Phpdoc stubs, for phan and IDEs and
  • Docbook documentation, for (once this is in pecl).

Things to remember to mention in the documentation for various methods:

  • Which ExcimerProfiler and ExcimerTimer property-setter methods take effect immediately versus only after start() is re-called.
    • Immediately: setMaxDepth, setFlushCallback, setCallback
    • After restart: setPeriod, setInterval, setEventType
  • ExcimerLog::offsetExists() will warn if passed a string, contrary to the interface's documentation.
  • ExcimerLog::offsetSet() and ExcimerLog::offsetUnset() are unusable and raise errors.
  • ExcimerLogEntry::getTimestamp() always returns wall time, or more specifically "unsuspended seconds since the ExcimerProfiler was created". This is intentional, see details in T205059.

Related Objects

Event Timeline

EvanProdromou added a subscriber: EvanProdromou.

I'm quitting this job I shouldn't have taken in the first place. I think it'd be a great first task for our soon-to-be-hired tech writer.

Change 533147 had a related patch set uploaded (by Tim Starling; owner: Tim Starling):
[mediawiki/php/excimer@master] Add documentation in the form of PHP stubs

Change 533147 merged by jenkins-bot:
[mediawiki/php/excimer@master] Add documentation in the form of PHP stubs

Anomie assigned this task to tstarling.