Hello folks,
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
For discussion any time of course, but definitely tomorrow at the meeting.
-- Ryan
It seems my message exceeded a size threshold for the list. Here is a Markdown version, both attached and inline below.
From: Ryan Davies Ryan.Davies@canarie.ca Date: Tuesday, September 25, 2018 at 10:22 To: GNA Mapping initiative gren-mapping-wg@lists.nordu.net Subject: User Stories draft
Hello folks,
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
For discussion any time of course, but definitely tomorrow at the meeting.
-- Ryan
# GREN Harmonized Mapping Initiative: User Stories [DRAFT] ====================
*Author: Ryan Davies, GREN Map Working Group* *Software Developer, CANARIE Inc.* *Ryan.Davies@canarie.ca* *613-229-3730* *September 2018* *canarie.ca | @canarie_inc*
# # Introduction
The GREN Mapping Initiative’s initial objective is to define a schema for the communication of network data. This can then be used as a source of NREN data for various map visualization implementations. To ensure that the schema is sufficiently complete, compatible, and convenient for all foreseen uses, we are compiling a list of features currently offered by existing map implementations, and for near-future visualization goals.
These features are described as user stories. They are not meant to be comprehensive descriptions of the feature, nor are they prescriptive in terms of implementation. However, full coverage of existing and planned features is desired.
Once this list has been generally accepted by the community, we will derive data schema requirements from it.
## Definitions
* __Map Viewer__: NREN user, NREN administrator/provider, prospective or current NREN funder, member of the public. * __Site__: NREN connected institution, POP, or Internet Exchange; from all participating NRENs.
## Consumption User Stories
### Sites
As a Map Viewer, I wish to see a list of Sites, represented graphically on a zoomable, geographic map, with, optionally, labels.
### Links
As a Map Viewer, I wish to see the intra- and inter-NREN links (physical or logical) on the map and, optionally, labels.
### More Information
As a Map Viewer, I wish to hover over a Site or a link and see more information about that item. (Specifics about what information to present shall be left to each visualization implementation of the map.) I also wish to be able to click on the item for additional information in an extended pane. (Again, specifics left to implementation.)
### Link Disambiguation
As a Map Viewer, I wish to clearly see and distinguish between all of the links between the same two Sites, when there is more than one.
### Site Ownership
As a Map Viewer, I wish to identify to which NREN any given Site belongs, and also, by inference, the partner at each end of a link.
### Link Ownership
As a Map Viewer, I wish to see who owns, maintains, provides, and funds each link.
### Link Capacity
As a Map Viewer, I wish to see the capacity of each link.
### Link Type
As a Map Viewer, I wish to distinguish between each type of link. Types could include circuits, logical compound links, undersea cables, satellite links, etc.
### NREN/Region Filter
As a Map Viewer, I wish to filter the map view to show only Sites and links associated with a single NREN, or a single region.
### Inter-NREN Filter
As a Map Viewer, when the above NREN filter is engaged so that only a single NREN’s Nodes and links is being shown, I wish to filter the map view to show only Sites and links that do not cross to other NRENs. Alternatively, distinguishing those types of links from intra-NREN links is acceptable.
### Link Length
As a Map Viewer, I wish to see the length of the “active” (hovered or clicked) link’s physical (geographic) length.
### Infinite Scroll
As a Map Viewer, I wish to scroll freely east or west indefinitely, looping around the map as required.
### Activity Metrics
As a Map Viewer, I wish to see a graph of recent activity over a given link along with its extended information, and potentially also the most current activity level at all times. Activity is a term that includes usage and incidents.
### Point-to-Point Connectivity
As a Map Viewer, I wish to select any two Sites, and be shown the primary route over which data would travel between those Sites under normal GREN/NREN configuration.
### Site Type Filter
As a Map Viewer, I wish to filter/highlight the list of Nodes shown to a single type/interest. For example, filter to Internet Exchanges. For another example, highlight research centres supporting astronomy.
## Administrative User Stories
### Default Centring
As a map visualization administrator, I wish to configure where the map is centred by default, and also the default zoom level.
### Link Waypoints
As a map source data provider (usually on behalf of an NREN), I wish to be able to define a custom compound line for each link, consisting of segments between intermediate waypoints. This is to allow increased disambiguation, a geographically-acccurate path for the link, or an intentionally non-geographically-accurate logical layout.
### Logos/Branding
As an NREN administrator, I wish to be able to specify a font colour and logo for each label (of a Site or link).
On 25 Sep 2018, at 16:36, Ryan Davies wrote:
It seems my message exceeded a size threshold for the list. Here is a Markdown version, both attached and inline below.
Sorry about that! The listserver defaults are, well, ancient. It’s was set for a 40 kByte msg limit ;-)
Fixed.
/Lars
Ryan,
A few small comments inline… probably the main high level one is ensuring I understand the scope of this as an advocacy and outreach tool or as a engineering tool?
On Sep 25, 2018, at 10:36 AM, Ryan Davies Ryan.Davies@canarie.ca wrote:
It seems my message exceeded a size threshold for the list. Here is a Markdown version, both attached and inline below.
From: Ryan Davies <Ryan.Davies@canarie.ca mailto:Ryan.Davies@canarie.ca> Date: Tuesday, September 25, 2018 at 10:22 To: GNA Mapping initiative <gren-mapping-wg@lists.nordu.net mailto:gren-mapping-wg@lists.nordu.net> Subject: User Stories draft
Hello folks,
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
For discussion any time of course, but definitely tomorrow at the meeting.
-- Ryan
# GREN Harmonized Mapping Initiative: User Stories [DRAFT] ====================
*Author: Ryan Davies, GREN Map Working Group* *Software Developer, CANARIE Inc.* *Ryan.Davies@canarie.ca mailto:Ryan.Davies@canarie.ca* *613-229-3730* *September 2018* *canarie.ca http://canarie.ca/ | @canarie_inc*
# # Introduction
The GREN Mapping Initiative’s initial objective is to define a schema for the communication of network data. This can then be used as a source of NREN data for various map visualization implementations. To ensure that the schema is sufficiently complete, compatible, and convenient for all foreseen uses, we are compiling a list of features currently offered by existing map implementations, and for near-future visualization goals.
These features are described as user stories. They are not meant to be comprehensive descriptions of the feature, nor are they prescriptive in terms of implementation. However, full coverage of existing and planned features is desired.
Once this list has been generally accepted by the community, we will derive data schema requirements from it.
## Definitions
- __Map Viewer__: NREN user, NREN administrator/provider, prospective or current NREN funder, member of the public.
- __Site__: NREN connected institution, POP, or Internet Exchange; from all participating NRENs.
## Consumption User Stories
### Sites
As a Map Viewer, I wish to see a list of Sites, represented graphically on a zoomable, geographic map, with, optionally, labels.
### Links
As a Map Viewer, I wish to see the intra- and inter-NREN links (physical or logical) on the map and, optionally, labels.
ahh inter-NREN… glad you touched on this… one challenge we will need to tackle when network A and B are both providing models of their networks and the link to each other, there needs to be some approach that allows us to know that we have 2 representations of the same link and that its ok to deduplicate. Additionally its important to know that these particular links are NREN interconnections.
### More Information
As a Map Viewer, I wish to hover over a Site or a link and see more information about that item. (Specifics about what information to present shall be left to each visualization implementation of the map.) I also wish to be able to click on the item for additional information in an extended pane. (Again, specifics left to implementation.)
### Link Disambiguation
As a Map Viewer, I wish to clearly see and distinguish between all of the links between the same two Sites, when there is more than one.
### Site Ownership
As a Map Viewer, I wish to identify to which NREN any given Site belongs, and also, by inference, the partner at each end of a link.
### Link Ownership
As a Map Viewer, I wish to see who owns, maintains, provides, and funds each link.
### Link Capacity
As a Map Viewer, I wish to see the capacity of each link.
we should call out exactly what this means presumably some form of bits / sec.
### Link Type
As a Map Viewer, I wish to distinguish between each type of link. Types could include circuits, logical compound links, undersea cables, satellite links, etc.
### NREN/Region Filter
As a Map Viewer, I wish to filter the map view to show only Sites and links associated with a single NREN, or a single region.
### Inter-NREN Filter
As a Map Viewer, when the above NREN filter is engaged so that only a single NREN’s Nodes and links is being shown, I wish to filter the map view to show only Sites and links that do not cross to other NRENs. Alternatively, distinguishing those types of links from intra-NREN links is acceptable.
### Link Length
As a Map Viewer, I wish to see the length of the “active” (hovered or clicked) link’s physical (geographic) length.
When you say length here do we really mean link latency? or possibly as the crow flies between the 2 endpoints. Reason I ask is that its very difficult to know the length in some cases especially when you do not control fiber in ground up.
At a technical level with a set of points finding distance is very doable, Im not sure I understand how this would be used by the viewer I guess?
more broadly this is really interesting area but the use cases rapidly get out of advocacy and into network engineering maybe?
### Infinite Scroll
As a Map Viewer, I wish to scroll freely east or west indefinitely, looping around the map as required.
### Activity Metrics
As a Map Viewer, I wish to see a graph of recent activity over a given link along with its extended information, and potentially also the most current activity level at all times. Activity is a term that includes usage and incidents.
This could use some constraining I suspect at some point but the idea is you want the ability to for the map to display time series metrics that are likely pulled from a secondary data source?
### Point-to-Point Connectivity
As a Map Viewer, I wish to select any two Sites, and be shown the primary route over which data would travel between those Sites under normal GREN/NREN configuration.
So this raises a few questions:
1. what route selection criteria are you envisioning here and how do you know whether this lines up with reality in production? 2. I wonder to what extent these maps will be layer1 , 2 or 3 in nature? 3, finding the shortest by some measure or by some definable measure can be useful especially if it does not line up with production.
more broadly this is really interesting area but the use cases rapidly get out of advocacy and into network engineering?
### Site Type Filter
As a Map Viewer, I wish to filter/highlight the list of Nodes shown to a single type/interest. For example, filter to Internet Exchanges. For another example, highlight research centres supporting astronomy.
## Administrative User Stories
### Default Centring
As a map visualization administrator, I wish to configure where the map is centred by default, and also the default zoom level.
### Link Waypoints
As a map source data provider (usually on behalf of an NREN), I wish to be able to define a custom compound line for each link, consisting of segments between intermediate waypoints. This is to allow increased disambiguation, a geographically-acccurate path for the link, or an intentionally non-geographically-accurate logical layout.
### Logos/Branding
As an NREN administrator, I wish to be able to specify a font colour and logo for each label (of a Site or link).
<GREN Map User Stories - DRAFT v0.1.md>_______________________________________________ Gren-mapping-wg mailing list Gren-mapping-wg@lists.nordu.net mailto:Gren-mapping-wg@lists.nordu.net https://lists.nordu.net/listinfo/gren-mapping-wg https://lists.nordu.net/listinfo/gren-mapping-wg
On 25 Sep 2018, at 16:22, Ryan Davies wrote:
Hello folks,
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
Ryan, thanks for this. This is an excellent start. I have a few additions I will try to enter before the meeting Wednesday.
Would it be useful to assemble a collection of know network maps, so that we can check that those are represented by the user stories.
/Lars — Lars Fischer - Strategy & Policy, NORDUnet lars@nordu.net, +45 2288 1729, @lpfischer
Hi Everyone,
I've pulled this into a Word document (attached), and added some rough comments.
About to dial in.
Regards, Tom
-----Original Message----- From: Gren-mapping-wg [mailto:gren-mapping-wg-bounces@lists.nordu.net] On Behalf Of Lars Fischer Sent: 26 September 2018 01:16 To: Ryan Davies Cc: GNA Mapping initiative Subject: Re: [Gren-mapping-wg] User Stories draft
On 25 Sep 2018, at 16:22, Ryan Davies wrote:
Hello folks,
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
Ryan, thanks for this. This is an excellent start. I have a few additions I will try to enter before the meeting Wednesday.
Would it be useful to assemble a collection of know network maps, so that we can check that those are represented by the user stories.
/Lars — Lars Fischer - Strategy & Policy, NORDUnet lars@nordu.net, +45 2288 1729, @lpfischer
_______________________________________________ Gren-mapping-wg mailing list Gren-mapping-wg@lists.nordu.net https://lists.nordu.net/listinfo/gren-mapping-wg
On 26 Sep 2018, at 16:00, Tom Fryer wrote:
Hi Everyone,
I've pulled this into a Word document (attached), and added some rough comments.
Tom, unfortunately documents diverged a bit. Here’s a revision of Ryan’s original document w/ track changes edits. Can you pull the two into one?
Looking forward to the wiki ;-)
/Lars
Hi Lars,
Many thanks - yes I'll merge and get the wiki set up asap.
Best regards, Tom
-----Original Message----- From: Lars Fischer [mailto:lars@nordu.net] Sent: 26 September 2018 16:49 To: Tom Fryer Cc: Ryan Davies; GNA Mapping initiative Subject: Re: [Gren-mapping-wg] User Stories draft
On 26 Sep 2018, at 16:00, Tom Fryer wrote:
Hi Everyone,
I've pulled this into a Word document (attached), and added some rough comments.
Tom, unfortunately documents diverged a bit. Here’s a revision of Ryan’s original document w/ track changes edits. Can you pull the two into one?
Looking forward to the wiki ;-)
/Lars -- Lars Fischer - Strategy & Policy, NORDUnet lars@nordu.net, +45 2288 1729, @lpfischer
Hello Everyone,
Attached is the merged document. I think it's all in there, but please do double-check. As I said, my comments were put together quickly, so I'll put more thought into it on the flight over to Ottawa on Monday.
You will find the wiki space at: https://wiki.geant.org/display/GlobalMap/Global+Interactive+Map. You should all have write-access.
Best regards, Tom
-----Original Message----- From: Lars Fischer [mailto:lars@nordu.net] Sent: 26 September 2018 16:49 To: Tom Fryer Cc: Ryan Davies; GNA Mapping initiative Subject: Re: [Gren-mapping-wg] User Stories draft
On 26 Sep 2018, at 16:00, Tom Fryer wrote:
Hi Everyone,
I've pulled this into a Word document (attached), and added some rough comments.
Tom, unfortunately documents diverged a bit. Here’s a revision of Ryan’s original document w/ track changes edits. Can you pull the two into one?
Looking forward to the wiki ;-)
/Lars -- Lars Fischer - Strategy & Policy, NORDUnet lars@nordu.net, +45 2288 1729, @lpfischer
On 26 Sep 2018, at 18:32, Tom Fryer wrote:
Hello Everyone,
Attached is the merged document.
Thanks, Tom. Great job.
You will find the wiki space at: https://wiki.geant.org/display/GlobalMap/Global+Interactive+Map. You should all have write-access.
Excellent. To test that I indeed have write permission, I created a page for documents in progress:
https://wiki.geant.org/display/GlobalMap/Documents+in+Progress
and made it hold just a list of attached documents, and uploaded the user stories document. As Confluence does versioning of attached documents, I removed the version numbers from the file names. Click of the little arrow to the left of a file name to see the versions. Dragging a file with the same name as an existing file into the “upload” box automatically make it the new version.
/Lars
PS: I don’t really have an opinion on how to organise wiki pages, but I did feel that experience from today show that a document repository is useful ;-)
Thanks for compiling this, Tom. And for all of the contributions by everyone who's chimed in so far.
I'd like to make sure we keep in mind that this is just a big ol' list of things we think people might want to do with the network map data. (And, in a few cases, the maintenance/curation of said data.) It is not meant to delve into utility, repercussions, prioritization, implementation, etc. The intention is that we eventually derive requirements (for round one) and then a data format implementation from this, but we're not there yet. Though all comments are certainly appreciated, discussion about the next phase may be better off happening in another medium/document. Of course, if the discussion leads to a question about whether to include the feature story or change it substantially, then it is fully appropriate, so don't take this opinion as a sweeping indiscriminant one! Anyway, I have a few specific comments in this general vein, but I will make them inline in the doc.
Cheers, Ryan
On 2018-09-26, 15:23, "Gren-mapping-wg on behalf of Lars Fischer" <gren-mapping-wg-bounces@lists.nordu.net on behalf of lars@nordu.net> wrote:
On 26 Sep 2018, at 18:32, Tom Fryer wrote:
> Hello Everyone, > > Attached is the merged document.
Thanks, Tom. Great job.
> You will find the wiki space at: > https://wiki.geant.org/display/GlobalMap/Global+Interactive+Map. You > should all have write-access.
Excellent. To test that I indeed have write permission, I created a page for documents in progress:
https://wiki.geant.org/display/GlobalMap/Documents+in+Progress
and made it hold just a list of attached documents, and uploaded the user stories document. As Confluence does versioning of attached documents, I removed the version numbers from the file names. Click of the little arrow to the left of a file name to see the versions. Dragging a file with the same name as an existing file into the “upload” box automatically make it the new version.
/Lars
PS: I don’t really have an opinion on how to organise wiki pages, but I did feel that experience from today show that a document repository is useful ;-) -- Lars Fischer - CTO, NORDUnet lars@nordu.net, +45 2288 1729, @lpfischer
_______________________________________________ Gren-mapping-wg mailing list Gren-mapping-wg@lists.nordu.net https://lists.nordu.net/listinfo/gren-mapping-wg
On 25 Sep 2018, at 16:22, Ryan Davies wrote:
I compiled that list of user stories we discussed, attached. It's intentionally a bit terse, but hopefully provides a starting point. Did I miss any stories, or miss the mark on any of those that are there?
Ryan, all,
as input for the meeting later today, I’ve added a few additional user stories. I’m not sure I got a complete set, they are mostly meant as examples and input for discussion.
See you later,
/Lars
gren-mapping-wg@lists.nordu.net
-
Edward Balas -
Lars Fischer -
Ryan Davies -
Tom Fryer