Neither the exclamation points nor the qualifiers add much here. They are out of character with the rest of the doc - I'd cut them out.
It would be good to note the historical status of this document and point to
src/python/pants/engine/exp/README.mdas the current source of truth. Lots of what it contains is obsolete, including issues at the bottom marked wont-fix due to the new concept of a front end being introduced.
[engine] Split engine docs from example docs
Review Request #3734 — Created April 20, 2016 and submitted
|benjyw, gmalmquist, jsirois, patricklaw, wisechengyi|
Split engine-specific docs out, added a few concrete example task declarations, and moved topics specific to the examples into the
Historysection to the
expdoc, and indicated in the
examplesdoc that some of it is historical.
Revision 2 (+195 -145)