-
Notifications
You must be signed in to change notification settings - Fork 422
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
first pass at better docs for declarative #1046
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice improvement for the simplified plotting docs. Most of the suggested changes are to improve cross-linking to the relevant docs in other projects. Sphinx is weird.
metpy/plots/declarative.py
Outdated
object. | ||
|
||
There are three pre-defined projections that can be called with a short name: | ||
Lambert Conformal ('lcc'), Mercator ('mer'), or polar-stereographic ('ps'). Additionally, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should "Conformal" be "conformal"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've seen it both ways...we'll go lower case hear and I added "conic" to make it a more inline with using "lcc"
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm ok with leaving it capital if polar stereographic is also capitalized.
I also found two traits that I missed! I've added short descriptions for |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pending CI.
Merging over the skewT test failures on Travis. |
This is a work in progress that partially addresses #1016 with improved documentation for the declarative syntax. Feedback welcome from all.
One question: there are a number of attributes that are listed in the online documentation that can't actually be set by the user, is there a way to not include those? I have left those attributes with the default language. Some examples of these attributes are: cross_validatation_lock, griddata, name, parent, and plotdata.