mirror of
https://we.phorge.it/source/phorge.git
synced 2024-11-29 18:22:41 +01:00
Remove references to __init__.php from docs
Test Plan: Regenerate docs. Reviewers: btrahan, epriestley Reviewed By: epriestley CC: aran, Koolvin Maniphest Tasks: T1103 Differential Revision: https://secure.phabricator.com/D2640
This commit is contained in:
parent
8d37576bd8
commit
fd10bcea48
2 changed files with 27 additions and 42 deletions
|
@ -37,10 +37,6 @@ containing the file ##DerpController.php## with the class
|
|||
which returns some @{class:AphrontResponse} object. The class would probably
|
||||
extend @{class:PhabricatorController}.
|
||||
|
||||
plus an auto-generated ##__init__.php## file.
|
||||
|
||||
NOTE: ##__init.php__## files are generated and maintained via `arc lint`.
|
||||
|
||||
If ##Derp## were (relatively) complex, one could reasonably expect to see
|
||||
the following directory layout:
|
||||
|
||||
|
@ -54,17 +50,17 @@ the following directory layout:
|
|||
phabricator/src/applications/derp/view/
|
||||
phabricator/src/applications/conduit/method/derp/
|
||||
|
||||
(The following two folders are also likely to be included for javascript and
|
||||
css respectively. However, static resources are largely outside the scope of
|
||||
(The following two folders are also likely to be included for JavaScript and
|
||||
CSS respectively. However, static resources are largely outside the scope of
|
||||
this document. See @{article:Adding New CSS and JS}.)
|
||||
|
||||
phabricator/webroot/rsc/js/application/derp/
|
||||
phabricator/webroot/rsc/css/application/derp/
|
||||
phabricator/webroot/rsrc/js/application/derp/
|
||||
phabricator/webroot/rsrc/css/application/derp/
|
||||
|
||||
These directories under ##phabricator/src/applications/derp/## represent
|
||||
the basic set of class types from which most Phabrictor applications are
|
||||
assembled. Each would contain a class file and an ##__init__.php## file.
|
||||
For ##Derp##, these classes could be something like:
|
||||
assembled. Each would contain a class file. For ##Derp##, these classes could be
|
||||
something like:
|
||||
|
||||
- **DerpConstants**: constants used in the ##Derp## application.
|
||||
- **DerpController**: business logic providing functionality for a given
|
||||
|
@ -89,18 +85,8 @@ For ##Derp##, these classes could be something like:
|
|||
functionality that is accessible over Conduit.
|
||||
|
||||
However, it is likely that ##Derp## is even more complex, and rather than
|
||||
containing a class and an ##__init__.php## file, each directory has
|
||||
subdirectories of its own. A typical example happens around the CRUD of an
|
||||
object:
|
||||
|
||||
phbaricator/src/application/derp/controller/base/
|
||||
phabricator/src/application/derp/controller/delete/
|
||||
phabricator/src/application/derp/controller/edit/
|
||||
phabricator/src/application/derp/controller/list/
|
||||
phabricator/src/application/derp/controller/view/
|
||||
|
||||
Which would then each contain a class and an ##__init__.php## file mapping to
|
||||
corresponding classes
|
||||
containing one class, each directory has several classes. A typical example
|
||||
happens around the CRUD of an object:
|
||||
|
||||
- **DerpBaseController**: typically extends @{class:PhabricatorController},
|
||||
implements ##buildStandardPageResponse## with the ##Derp## application name
|
||||
|
|
|
@ -120,8 +120,7 @@ Now, run ##arc liberate## to regenerate the static resource map:
|
|||
|
||||
libcustom/ $ arc liberate src/
|
||||
|
||||
This will automatically create and update ##__init__.php## files, and regenerate
|
||||
the static map of the library.
|
||||
This will automatically regenerate the static map of the library.
|
||||
|
||||
= What You Can Extend And Invoke =
|
||||
|
||||
|
|
Loading…
Reference in a new issue