Github user geomacy commented on a diff in the pull request:
https://github.com/apache/brooklyn-docs/pull/159#discussion_r108867638
--- Diff: guide/dev/tips/index.md ---
@@ -39,21 +39,32 @@ title: Miscellaneous Tips and Tricks
sensors and config keys can be re-used.
(Many are inherited from interfaces, where they are declared as
constants,
e.g. ``Attributes`` and ``UsesJmx``.)
-
+
* Understand the location hierarchy: software process entities typically
get an ``SshMachineLocation``,
and use a ``*SshDriver`` to do what they need. This will usually have a
``MachineProvisioningLocation`` parent, e.g. a
``JcloudsLocation`` (e.g. AWS eu-west-1 with credentials) or possibly a
``LocalhostMachineProvisioningLocation``.
Clusters will take such a ``MachineProvisioningLocation`` (or a
singleton list); fabircs take a list of locations.
Some PaaS systems have their own location model, such as
``OpenShiftLocation``.
-Finally, don't be shy about [talking with
others]({{site.path.website}}/community/),
-that's far better than spinning your wheels (or worse, having a bad
experience),
-plus it means we can hopefully improve things for other people!
+* Finally, don't be shy about [talking with
others]({{site.path.website}}/community/),
+ that's far better than spinning your wheels (or worse, having a bad
experience),
+ plus it means we can hopefully improve things for other people!
+## YAML Blueprint Debugging
+
+* Brooklyn will reject any YAML blueprint that contains syntax errors and
will alert the user of such errors.
+
+* However, it is possible to create a blueprint that is syntactically
legal but results in runtime problems
+ for Brooklyn (for example, if an enricher's `enricher.producer` value is
not immediately resolvable).
+
+* If Brooklyn misbehaves or freezes after deploying a blueprint, run the
`jstack <brooklyn-pid>` command to view
--- End diff --
I wouldn't use 'misbehaves' here. How about just "If Brooklyn appears to
freeze"?
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
