Skip to content

Conversation

the-metalgamer
Copy link
Contributor

No description provided.

@the-metalgamer
Copy link
Contributor Author

Any update on this?

@rnestler
Copy link
Member

@dbrgn, @dns2utf8 any opinions? I currently don't have time to look at it. Is this related to #14 ?

14-draft.json Outdated
"monthly",
"weekly",
"daily",
"hourly"
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe this should include "other". What if there is biyearly payment or some other type of system?

If renewal interval is "other", then the description must be filled out. (I don't think that's something we can enforce with JSON schema though. But we can document it.)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Might be a good idea! We add it now!

14-draft.json Outdated
@@ -1132,6 +1132,49 @@
"end"
]
}
},
"membership_plans": {
"description": "A list of the different memberhsip plans your hackerspace might have.",
Copy link
Contributor

Choose a reason for hiding this comment

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

*membership

14-draft.json Outdated
"type": "string"
},
"value": {
"description": "How much does this plan cost!",
Copy link
Contributor

Choose a reason for hiding this comment

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

replace ! with ?

14-draft.json Outdated
"type": "string"
},
"renewal_interval": {
"description": "When does the membership be renewed! If you select other, please specify in the description what your renewal interval is.",
Copy link
Contributor

Choose a reason for hiding this comment

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

Rewrite the first sentence to to How often is the membership renewed?

CHANGELOG.md Outdated
@@ -13,3 +13,4 @@ Changes should start with one of the following tags:
- [added] The `contact.keymasters` array items can also contain a `xmpp` field
- [changed] The value in `sensors.account_balance` can now be any ISO 4217 string
- [added] The `timezone` key was added under `location`
- [added] The `membership_plans` was added to represent membership plans a space might have
Copy link
Contributor

Choose a reason for hiding this comment

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

Can you add "key" between "membership_plans" and "was"?

@the-metalgamer
Copy link
Contributor Author

Any update on this?

@rnestler
Copy link
Member

Any update on this?

Sorry for the delay! One doesn't get a notification from Github when you push a commit to a branch. So to avoid us not noticing when you add the requested changes, just add a comment which mentions the reviewer who requested them (@dbrgn in this case).

@dbrgn
Copy link
Contributor

dbrgn commented May 26, 2017

Looks good to me now! @rnestler, agree?

@dbrgn dbrgn requested a review from rnestler May 26, 2017 21:19
Copy link
Member

@rnestler rnestler left a comment

Choose a reason for hiding this comment

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

Some bike-shedding and a more serious question about membership renewal interval vs. payment interval.

14-draft.json Outdated
"type": "object",
"properties": {
"name": {
"description": "The name of the membership plan. For example Student Membership, Normal Membership etc...",
Copy link
Member

Choose a reason for hiding this comment

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

Minor nitpick: I would use either etc. or ...:

  • "The name of the membership plan. For example Student Membership, Normal Membership, ..."
  • "The name of the membership plan. For example Student Membership, Normal Membership, etc."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed!

"description": "How often is the membership renewed? If you select other, please specify in the description what your renewal interval is.",
"type": "string",
"enum": [
"yearly",
Copy link
Member

Choose a reason for hiding this comment

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

Is "yearly" or "annually" more common?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think i would stick with "yearly" since it's more consistent with the other options.

"weekly",
"daily",
"hourly",
"other"
Copy link
Member

Choose a reason for hiding this comment

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

Do we now which intervals are most common? Maybe add bi-annually? Also at coredump for example we communicate 10CHF/month, but actually bill yearly and also membership is renewed yearly. How would we describe that?

{
  "name": "Student",
  "value": 10,
  "currency": "CHF",
  "renewal_interval": "monthly",
  "description": "Billed annually"
}

or

{
  "name": "Student",
  "value": 120,
  "currency": "CHF",
  "renewal_interval": "yearly"
}

I just see some potential for confusion here.

Copy link
Contributor

Choose a reason for hiding this comment

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

I guess the renewal and billing usually match, so we should probably chose the yearly renewal interval in our case.

Copy link
Member

Choose a reason for hiding this comment

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

I think we just need to document clearly, how it is intended to be used.

Copy link
Contributor

Choose a reason for hiding this comment

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

Yes, absolutely :) Any proposals for wording? Maybe How often is the membership renewed (billed)??

Copy link
Member

Choose a reason for hiding this comment

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

I think we could just add some concrete examples to the description string?

Copy link
Contributor

Choose a reason for hiding this comment

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

@the-metalgamer ok, do you want to do the necessary adjustments?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dbrgn Yes, but currently I'm thinking about how to incorporate the examples in the descriptions

Copy link
Member

Choose a reason for hiding this comment

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

We can also merge it as is and improve it later, to not stall this PR for such a long time.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

That might be a good idea!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dbrgn dbrgn merged commit 5cd9343 into SpaceApi:master Jun 8, 2017
@dbrgn
Copy link
Contributor

dbrgn commented Jun 8, 2017

Thanks!

dbrgn pushed a commit that referenced this pull request Jan 6, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants