erasmus-without-paper / ewp-specs-api-institutions

Specifications of EWP's Institutions API.
MIT License
0 stars 0 forks source link

Work on <relevant-academic-terms> #4

Closed wrygiel closed 7 years ago

wrygiel commented 7 years ago

Since I am not 100% sure which academic terms are supposed to be included in the Institutions API response, I have pushed them to a separate branch until I can document them properly.

If I remember correctly, this feature was endorsed by @janinamincer-daszkiewicz and @kaiqu. Could you please explain once more why we might need academic terms in Institutions API?

wrygiel commented 7 years ago

You can see my alpha revision here. As you can see, I had some problems documenting it, so I need your help.

kaiqu commented 7 years ago

Since I am not 100% sure which academic terms are supposed to be included in the Institutions API response, I have pushed them to a separate branch until I can document them properly.

If I remember correctly, this feature was endorsed by @janinamincer-daszkiewicz and @kaiqu. Could you please explain once more why we might need academic terms in Institutions API?

@janinamincer-daszkiewicz commented in Warsaw that it was useful to know what kind of Academic Year an IIA Partner uses (for matching against the local definition, I think). In the model, an Academic Year is basically a name (e.g. 2016/2017) + a collection of Academic Terms.

Thus, when a remote LOI is operative in a remote Academic Term, the local HEI knows which Academic Year is applicable.

wrygiel commented 7 years ago

@janinamincer-daszkiewicz commented in Warsaw that it was useful to know what kind of Academic Year an IIA Partner uses (for matching against the local definition, I think).

Year? Don't all partners use the same academic years (in northern hemisphere)? I believe it rather had something to do with determining which term is part of which year. But each Academic Term reference contains this information in itself, hence my question.

wrygiel commented 7 years ago

In other words, I don't yet understand what would be the use of including a list of terms in this particular API response. (Term-year relation will be provided in all the other API responses, whenever a term is referenced.) So, I think there must have been some other reason too, but I can't remember it.

kaiqu commented 7 years ago

In other words, I don't yet understand what would be the use of including a list of terms in this particular API response. (Term-year relation will be provided in all the other API responses, whenever a term is referenced.) So, I think there must have been some other reason too, but I can't remember it.

I see your point - maybe the argument was from before we decided that the Term/Year relation should be provided in all responses? I leave it to @janinamincer-daszkiewicz to answer this.