Provide information about statefulness, thread-safety, etc. of objects returned by factories

• Type: Improvement
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: None
• Fix Version/s: util-1.0.0, util-2.0.0, util-3.0.0, bridge-impl-2.0.0, bridge-impl-3.0.0, bridge-ext-1.0.0, bridge-ext-2.0.0, bridge-ext-3.0.0, bridge-ext-5.0.0, facesbridge-api-5.0.0, bridge-api-2.0.0, bridge-api-3.0.0, bridge-api-4.0.0, bridge-impl-4.0.0, bridge-impl-5.0.0, facesbridge-api-6.0.0, bridge-impl-6.0.0, bridge-ext-7.0.0
• Component/s: FacesBridge API, Liferay Faces Bridge API, Liferay Faces Bridge Ext, Liferay Faces Bridge Impl / Demos / Tests, Liferay Faces Util
• Labels: None

{markdown}
Liferay Faces contains many factories in its API, and it isn't always clear (to the implementer or the caller) whether an object returned from those factories is thread-safe, stateless, singleton, `ThreadLocal` etc. This task involves clarifying those aspects of objects returned by API factories in the JavaDoc. This task also involves explaining whether an object is expected to be used only within a thread.{markdown}