Test collaboration feature

[brettkromkamp]

The collaboration feature on maps needs to be properly tested. Ideally, this testing is done by two separate users (the map owner and the person with whom is being collaborated with).

The collaboration feature allows topic map collaboration in three distinct modes (all of which need to be separately tested):

• Can view (read-access only)
• Can comment (add notes to existing topics)
• Can edit (read/write access)

@navigator8 Would you be up for testing this feature with me? If yes, then I would need to know the email address you used to sign up with to Contextualise (collaboration is set up by providing the email address of the person you want to collaborate with).

[navigator8]

@brettkromkamp been waiting for this feature! I have sent my email via Twitter DM.

Best regards,

[brettkromkamp]

@navigator8 Thanks! I will add you as a collaborator to a map. You should see the map you've been added to (as a collaborator) in the "Maps I am collaborating on" tab in the "My map" view. I'll send you a (follow-up) message when ready. We'll test in the order outlined above (i.e., can view, can comment and can edit). I'll provide somewhat more in-depth "instructions" for each phase of testing. By the way, please call me Brett :)

[brettkromkamp]

@navigator8 I have already come across one (logical) bug. The new associations component allows you to create a quick/generic association in can-view (read-only) collaboration mode. I will fix that before we start testing.

[navigator8]

Hi Brett! Woke up to a new map in [My Maps I am collaborating on] !

[brettkromkamp]

Morning Farayi. Yep, I've added you as a collaborator to a map. You should have seen something similar to this:

The collaboration mode is "Can view" (read-only) so you should be seeing something similar to this (inside of the map):

You can navigate around the map, including accessing the "visualisations" like the network graph and the recently added tag cloud. You should not be able to do anything beyond that.

By the way, just to avoid confusion... the screenshot above shows some related topics; the map I've shared with you doesn't have any.

[navigator8]

Hi Brett! too late with these instructions :). I have already jumped in and tried to to create topics/ associations. Not possible in view mode.

[brettkromkamp]

Ok, yes... it's just to confirm that you cannot do anything you would expect not to be able to do in a read-only mode. Then the next test would be to change the collaboration mode to "Can comment". This is almost the same as the "Can view" (read-only) mode but you can also add notes (i.e., comments) to existing topics. Nothing more, though.

So, let me know when you have finished testing the "Can view" (read-only) mode and I will change your collaboration mode on this map to start the next round of testing :)

[navigator8]

Great stuff! I had a good play in the morning! I am about 10hours ahead of Norway 🇳🇴:). Upgrade my privileges to “ Can comment”.

Thanks.

Get Outlook for iOShttps://aka.ms/o0ukef

---

From: Brett Alistair Kromkamp notifications@github.com Sent: Thursday, July 23, 2020 4:54:51 PM To: brettkromkamp/contextualise contextualise@noreply.github.com Cc: Farayi Chambati flchambati@hotmail.com; Mention mention@noreply.github.com Subject: Re: [brettkromkamp/contextualise] Test collaboration feature (#90)

Ok, yes... it's just to confirm that you cannot do anything you would expect not to be able to do in a read-only mode. Then the next test would be to change the collaboration mode to "Can comment". This is almost the same as the "Can view" (read-only) mode but you can also add notes (i.e., comments) to existing topics. Nothing more, though.

So, let me know if when you have finished testing the "Can view" (read-only) mode and I will change your collaboration mode on this map to start the next round of testing :)

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/brettkromkamp/contextualise/issues/90#issuecomment-662817873, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ABZW4U7Y5AHO6OKMPH4UPE3R467BXANCNFSM4PEK565Q.

[brettkromkamp]

Done. You should be able to add a note (comment) to existing topics and the collaboration mode should indicate that you can comment (see screen shot, below):

And, just like the "Can view" mode, you should be able to navigate around the map but not add, change or delete anything.

By the way, I have added a bit of content and a related topic to the map to make it slightly more interesting than just a default, empty map :)

If you testing doesn't surface any bugs, we'll move on to the third and final test phase: "Can edit" (read/write access). Let me know how it goes!

[navigator8]

Hi Brett, I have added a few notes using different tests. One suggestions - are you able to add a label [user id etc] to show who has added the comment/note. This will well to see who has contributed what. You could even go a step further to show a by different colours, i.e. note border by owner/admin (one colour) and another colour for contributors.

[brettkromkamp]

Good suggestion, Farayi. I'll take a look at implementing it.

With regards to linking to other topics in in both normal topic text and notes... it's obviously possible. The syntax is the usual Markdown link syntax: [the link's text](the-topic-identifier). You don't have to specify the full URL, just the topic identifier for the topic you are linking to (Contextualise will infer the rest of the URL). Let's say you want to link to the "Home" topic from another topic; the way to specify the link in the topic text or note would be: [whatever link text you want to use](home).

[brettkromkamp]

@navigator8 Hi Farayi. In the meantime, do we move on to testing the third mode: "Can edit"? Did you come across any problems (or bugs) with the "Can comment" mode?

[navigator8]

Hi Brett!

Yes, please this is the fun bit. Wait and see what network I will create :)!

Get Outlook for iOShttps://aka.ms/o0ukef

---

From: Brett Alistair Kromkamp notifications@github.com Sent: Tuesday, July 28, 2020 4:57:28 PM To: brettkromkamp/contextualise contextualise@noreply.github.com Cc: Farayi Chambati flchambati@hotmail.com; Mention mention@noreply.github.com Subject: Re: [brettkromkamp/contextualise] Test collaboration feature (#90)

@navigator8https://github.com/navigator8 Hi Farayi. In the meantime, do we move on to testing the third mode: "Can edit"?

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/brettkromkamp/contextualise/issues/90#issuecomment-664776596, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ABZW4UZRPLVFMJTCAEBV4ADR5ZLDRANCNFSM4PEK565Q.

[brettkromkamp]

Ok, you now have read-write access to the map. You should, be able to do everything: create, update and delete topics, occurrences and associations. Let me know how it goes :)

[brettkromkamp]

@navigator8 Hi Farayi. I'm assuming you have finished testing the "Can edit" collaboration mode, or? If yes, thanks a lot! There is just one final thing to test with regards to collaboration: removing you as a collaborator on the topic map and you confirming that you do not have access to the map anymore.

[navigator8]

Hello Brett!

Yes, I did some testing. Happy for you to remove me as a collaborator.

Get Outlook for iOShttps://aka.ms/o0ukef

---

From: Brett Alistair Kromkamp notifications@github.com Sent: Saturday, August 1, 2020 6:51:47 AM To: brettkromkamp/contextualise contextualise@noreply.github.com Cc: Farayi Chambati flchambati@hotmail.com; Mention mention@noreply.github.com Subject: Re: [brettkromkamp/contextualise] Test collaboration feature (#90)

@navigator8https://github.com/navigator8 Hi Farayi. I'm assuming you have finished testing the "Can edit" collaboration mode, or? If yes, thanks a lot! There is just one final thing to test with regards to collaboration: removing you as a collaborator on the topic map and you confirming that you do not have access to the map anymore.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/brettkromkamp/contextualise/issues/90#issuecomment-667298205, or unsubscribehttps://github.com/notifications/unsubscribe-auth/ABZW4U5EM6QAHNOGIF6ZXGDR6MHEHANCNFSM4PEK565Q.

[brettkromkamp]

@navigator8 I have removed you as a collaborator. You shouldn't have access to the map anymore. Please confirm either way.

[navigator8]

Hi Brett

Ooops! Map has disappeared under [Maps I am collaborating on]]. Confirmed.

[brettkromkamp]

@navigator8 Excellent! Then I think we can conclude on the testing of the collaboration feature. Thanks for all of your help, Farayi! Really appreciate it!