Page MenuHomePhabricator

OOUI: Synchronise JS and PHP docs better
Closed, ResolvedPublic

Description

We should synchronise JS and PHP docs better, and preferably not by hand.

PHP docs are missing most class and constructor documentation. JS docs are missing most object properties documentation.

Also, we should probably use non-public access modifiers in PHP code more and document this status in JS.


Version: unspecified
Severity: normal

Details

Reference
bz72455

Event Timeline

bzimport raised the priority of this task from to Medium.Nov 22 2014, 3:46 AM
bzimport added a project: OOUI.
bzimport set Reference to bz72455.

gerritadmin wrote:

Change 168693 had a related patch set uploaded by Bartosz Dziewoński:
Fix a number of documentation syntax issues throughout the codebase

https://gerrit.wikimedia.org/r/168693

gerritadmin wrote:

Change 168835 had a related patch set uploaded by Bartosz Dziewoński:
Semiautomatically compare and synchronise JS and PHP docs

https://gerrit.wikimedia.org/r/168835

gerritadmin wrote:

Change 168693 merged by jenkins-bot:
Fix a number of documentation syntax issues throughout the codebase

https://gerrit.wikimedia.org/r/168693

gerritadmin wrote:

Change 168835 merged by jenkins-bot:
Semiautomatically compare and synchronise JS and PHP docs

https://gerrit.wikimedia.org/r/168835