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

Need to review best practices text to ensure that they consistently use an imperative style #193

Closed
6a6d74 opened this issue Jan 6, 2016 · 4 comments
Assignees
Labels

Comments

@6a6d74
Copy link
Contributor

6a6d74 commented Jan 6, 2016

In her email Kerry notes:

I like those worded in an imperative style like "xx should be yyy" , over those worded in the "how to" style. I think the latter kind should be rewritten to the former kind.
e.g. "How to describe relative positions" could be " Relative positions should be expressed in a machine-interpretable or human readable manner"

@lvdbrink lvdbrink added the bp label Jan 25, 2017
@lvdbrink
Copy link
Contributor

Only one remaining is Best Practice 10: Encoding spatial data

@lvdbrink
Copy link
Contributor

lvdbrink commented May 3, 2017

BP3: General linking > @6a6d74 to come up with a name

BP4: Use spatial data encodings that match your target audience > Suggested to @BillSwirrl

BP6: Multiple geometries > @andrea-perego to come up with a name

BP9: It's difficult to think of a good name... "Use relative positioning" (current name) sounds like you should always do relative positioning, which is not what we mean. My best attempt is "Use relative positioning for describing the position of spatial things relative to another" > @lieberjosh to come up with something

@lvdbrink
Copy link
Contributor

lvdbrink commented May 8, 2017

BP3, BP4, BP6 are done.

BP9: open

"Best Practice 11: Describe properties that change over time" is also problematic. What about "Provide information on the life cycle of spatial things"?

lvdbrink added a commit that referenced this issue May 8, 2017
@lvdbrink
Copy link
Contributor

lvdbrink commented May 8, 2017

BP11 title will be "Provide information on the changing nature of spatial things"

BP9 title will remain as is.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants