Skip to content
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

Merged
merged 1 commit into from Jun 12, 2019

Conversation

kgoebber
Copy link
Collaborator

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.

@dopplershift dopplershift added Area: Docs Affects documentation Type: Enhancement Enhancement to existing functionality labels Jun 6, 2019
@dopplershift dopplershift added this to the 0.11 milestone Jun 6, 2019
Copy link
Member

@dopplershift dopplershift left a 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 Show resolved Hide resolved
metpy/plots/declarative.py Outdated Show resolved Hide resolved
metpy/plots/declarative.py Outdated Show resolved Hide resolved
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,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should "Conformal" be "conformal"?

Copy link
Collaborator Author

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"

Copy link
Member

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.

metpy/plots/declarative.py Outdated Show resolved Hide resolved
metpy/plots/declarative.py Outdated Show resolved Hide resolved
metpy/plots/declarative.py Outdated Show resolved Hide resolved
@kgoebber
Copy link
Collaborator Author

kgoebber commented Jun 7, 2019

I also found two traits that I missed! I've added short descriptions for size and panels.

dopplershift
dopplershift previously approved these changes Jun 7, 2019
Copy link
Member

@dopplershift dopplershift left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pending CI.

@dopplershift
Copy link
Member

Merging over the skewT test failures on Travis.

@dopplershift dopplershift merged commit 57497c2 into Unidata:master Jun 12, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Area: Docs Affects documentation Type: Enhancement Enhancement to existing functionality
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants