Hi GREN Mapping Initiative folks,
We have had about two weeks to review the user stories document, and have made many changes to it, some of them obvious and some subtle. Attached, find the consolidated document, ready for submission to the GNA Tech WG for comment, along with our draft charter. Note that we are not seeking formal approval, only feedback.
You will note that it has been neutrally formatted with no corporate branding to speak of at this time. This is a conscious choice, to reflect the fact that this is a collaborative effort by the community, not unduly driven by a particular NREN or formal inter-NREN organisation. There has been some discussion about adopting our own unique new branding at some point in the future, but for now it's intentionally bland.
I'd like to submit to GNA Tech tomorrow if possible; please review as soon as you can. Of course, there will still be time for feedback before we submit to the NREN CEO Forum for their formal approval to form an official committee/working group.
Cheers, Ryan
On 11 Oct 2018, at 8:36, Ryan Davies wrote:
Hi GREN Mapping Initiative folks,
We have had about two weeks to review the user stories document, and have made many changes to it, some of them obvious and some subtle. Attached, find the consolidated document, ready for submission to the GNA Tech WG for comment, along with our draft charter. Note that we are not seeking formal approval, only feedback.
Ryan, thanks for your work on this.
Reviewing this, I see some confusion between user storied focused on the end-user mapping application, and those focused on the data that must exist for the application to work.
We have previously agreed that our focus is on data format, representation, and exchange. Capturing user requirements for the mapping application is of course important; we need those to derive the attributes / meta-data to record in the data exchange format. However, user stories that centre only on how the mapping applications works (infinite scroll, centering, zoom) do not inform the data requirements.
I think that in this iteration, we should focus on user stories that do inform the choice of data format and exchange, and we should make an effort to make sure the set if reasonably complete for at least a known set of mapping applications. The way I like to think about this, we are not trying to derive the requirements for a mapping application; we are trying to derive the requirements for the data that will allow such an application to be built.
To this end, I not that you have removed two user stories
- one about being able to show only inter-continental or inter-region links - one about being able to map links to specific (physical) cables
If we remove those, and the meta-data that go along with them, then there are types of maps that cannot be made from the data (i.e., without the first one, you can’t create the GNA map)
I’ve attached the document with some comments.
/Lars
Hi Lars,
Thanks for your thoughtful analysis. There are some great points in your e-mail and the document comments. Based on what you've brought up, it is clear that another round of editing is justified for that document.
Your point about some remaining stories not informing the data schema is especially well-taken:
· The infinite scroll should be relegated to the implementation document I've started.
· There are a couple of references to "zooming", though they are somewhat incidental, they can be removed if you like.
· I personally believe that centring could peripherally affect the data schema if we choose to support metadata that would inform that. For example, picture a visualisation that centres your view based on your identity, or IP address, or something (this is an imaginary scenario!) — if the map were to automatically centre on CANARIE for me when I visit it, I believe it should be up to CANARIE to specify where the "centre" should be. In our case, it might be southeast of the geographic centre to emphasize the cross-Atlantic and US links… maybe (or maybe not, but I believe we should be able to make that decision and specify it in the map metadata if we so choose). Open for debate of course.
To respond to a few other points you've raised in your e-mail and the document comments:
· I actually think that the idea of showing only inter-NREN/inter-region/inter-continental links is captured by the story "Link Type Filter", though this exact use case has not been mentioned. (Happy to add it.) Also, in reverse, by the "Inter-NREN Filter" story, which could be modified slightly to describe exactly what you suggest.
· The idea of mapping virtual links to physical links is an interesting one. I think it bears more discussion. Do any current visualisations show this kind of detail? Do any foreseeable implementations require it? Or is it maybe a good idea for Version Two?
· I like your suggestion (in the document's comments) about link traffic type. I'll add a story about that, and call it, perhaps "Link Traffic Filter".
· I do think that activity metrics may have an effect on our main data schema. I've been mulling over in my head (and with Tom at one point) the idea of requiring/providing a guaranteed-unique ID for each link. (This would also support disambiguation/deduplication after data updates, among other advantages. There are, of course, disadvantages. To be discussed later.) In any case, somehow primary-key identifying a link and its nodes would be required or at least highly beneficial for connecting supplementary data sources like activity metric feeds. I'd like to keep this in here, even if we don't get as far as developing a proper full schema for the supplemental data in the first round.
· I believe that determining how the data is stored (distributed vs. centralised) may indeed have an effect on the data schema. This is why we included the "Access" story. If it is unclear whether the story affects data schema, I think we should lean towards including it in this document.
Smaller notes:
· Yes, I meant "sites that support eduroam WiFi".
· The first sentence of the "Language" story is there so that it doesn't look like we forgot about the user in this story, and to clarify what is meant by the subsequent sentences.
I will distribute an updated document (with inline comment responses, in case this long e-mail was too hard to follow) shortly.
Upon reflection, I wonder if, instead of having a separate document for implementation-only user stories, we should include them in this document either in a separate section, or simply identified as not affecting the schema development. Any opinions, folks?
-- Ryan
From: Lars Fischer lars@nordu.net Date: Friday, October 12, 2018 at 09:48 To: Ryan Davies Ryan.Davies@canarie.ca Cc: GREN Mapping initiative gren-mapping-wg@lists.nordu.net Subject: Re: [Gren-mapping-wg] User Stories Draft for Submission to GNA Tech
On 11 Oct 2018, at 8:36, Ryan Davies wrote:
Hi GREN Mapping Initiative folks,
We have had about two weeks to review the user stories document, and have made many changes to it, some of them obvious and some subtle. Attached, find the consolidated document, ready for submission to the GNA Tech WG for comment, along with our draft charter. Note that we are not seeking formal approval, only feedback.
Ryan, thanks for your work on this.
Reviewing this, I see some confusion between user storied focused on the end-user mapping application, and those focused on the data that must exist for the application to work.
We have previously agreed that our focus is on data format, representation, and exchange. Capturing user requirements for the mapping application is of course important; we need those to derive the attributes / meta-data to record in the data exchange format. However, user stories that centre only on how the mapping applications works (infinite scroll, centering, zoom) do not inform the data requirements.
I think that in this iteration, we should focus on user stories that do inform the choice of data format and exchange, and we should make an effort to make sure the set if reasonably complete for at least a known set of mapping applications. The way I like to think about this, we are not trying to derive the requirements for a mapping application; we are trying to derive the requirements for the data that will allow such an application to be built.
To this end, I not that you have removed two user stories
* one about being able to show only inter-continental or inter-region links * one about being able to map links to specific (physical) cables
If we remove those, and the meta-data that go along with them, then there are types of maps that cannot be made from the data (i.e., without the first one, you can’t create the GNA map)
I’ve attached the document with some comments.
/Lars -- Lars Fischer - Strategy & Policy, NORDUnet lars@nordu.netmailto:lars@nordu.net, +45 2288 1729, @lpfischer
Ryan,
thanks for your response. A few comments ahead of today’s meeting.
Based on what you've brought up, it is clear that another round of editing is justified for that document.
I agree. Let’s discuss in our team meeting later today.
· I actually think that the idea of showing only inter-NREN/inter-region/inter-continental links is captured by the story "Link Type Filter", though this exact use case has not been mentioned. (Happy to add it.) Also, in reverse, by the "Inter-NREN Filter" story, which could be modified slightly to describe exactly what you suggest.
Right. As long as we can use the data to (semi)automatically create the GNA map, I’m fine.
· The idea of mapping virtual links to physical links is an interesting one. I think it bears more discussion. Do any current visualisations show this kind of detail? Do any foreseeable implementations require it? Or is it maybe a good idea for Version Two?
It came from a specific requires from out friends at RNP. I mainly included it as an example of the kind of metadata we may need in order to provide for the applications people have in mind, and as an example of data that is unlikely to be available for all links. I’m having this as a “phase 2” thing, but we must as a minimum 1) have a data format that is expandable to contain this type of information, and 2) have data, APIs, and applications that can handle such information if provided, but also work when it’s not there.
I've been mulling over in my head (and with Tom at one point) the idea of requiring/providing a guaranteed-unique ID for each link.
Oh. Yes, it would be great if that existed. Inventing unique ID’s is also one of those things that look simple on the face of it, but then turns out to have a lot of complications.
This would be a great thing to feed back to the GNA Engineering WG: “guys, we need this ID, can you please make it happen?”. It’s a topic for a separate work group.
See you in a few hours,
/Lars
gren-mapping-wg@lists.nordu.net