Pyomo decorators need documented

[michaelbynum]

[blnicho]

Starting a list of decorators that should be documented:

• decorator notation for declaring Pyomo components
• deprecation decorator (Document deprecation decorator #944)
• the custom block decorator

[carldlaird]

Added the custom block decorator to Bethany's list.

[goroderickgo]

I can't promise anything any time soon, but my team has been starting to use the decorator syntax for model components (e.g., @self.Constraint, etc.) and would greatly benefit from having this functionality documented. With some guidance, I'd be happy to (eventually) contribute something to the Pyomo documentation.

[blnicho]

@goroderickgo, this slide from the Pyomo Workshop materials is a good place to start.

[liyingbin1213]

you can also see more examples in this book. https://jckantor.github.io/MO-book/intro.html