How to communicate

This page shows tools and best practices to communicate efficiently about code changes or operations activities.

Ways of communication

Discussion spaces

Our primary discussion spaces are IRC, DevCentral and here on Agora:

Primary discussion spaces

Space	How to join	Scope
IRC	Libera.chat #nasqueron-ops	Discussions about servers, infrastructure, operations, access. Also, as it's currently our main discussion space, you're welcome to hangout there if you want to chat with fellow nasquenautes.
DevCentral	Browse https://devcentral.nasqueron.org	Tasks, project management, status update, sprints, ideas
Agora	You're here! Request an account	Documentation, projects, idea, personal notes

We also use Jitsi as video-conference platform and some members currently use Discord to organize their contributions:

Known discussion spaces

Space	How to join	Scope
Discord	https://discord.gg/DZQK8Dd8Xd	ServPulse
Jitsi	https://meet.jit.si/nasqueron	Any topic. Tip: If you're first on the meeting, you can login through GitHub to open it.

By project

• Nasqueron Operations SIG uses IRC: Libera.chat #nasqueron-ops
• Eli and Amine work on Discord for ServPulse

Tips for audio and video meeting

A headset can help a lot to get clear communication, without echo or reverb. When you don't have it, try to mute yourself when you don't speak (Jitsi) or enable push-to-talk feature (Discord).

Dereckson has a spare USB headset from Sennheiser if you need one.

Share logs, screenshots

Core recommandations

• DO: use appropriate tools to share information through a short link
• DON'T: use screenshots to share text, text must be shared as text
• DON'T: copy/paste full logs in chat
• DON'T: share logs with privacy data / PII, in that case give a reference to go to that log

Tools to use

• To share directly the ouput of a command
  • Termbin: command | nc termbin.com 9999
  • Arcanist to publish to DevCentral: command | arc paste --
• To share clipboard content
  • https://dpaste.com/
  • DevCentral: create paste, that gives a reference to put in other objects (tasks, differential), use {P100} for direct inclusion or P100 for link
• To share source code
  • Pastebin are totally appropriated too
  • You can also use GitHub Gist: https://gist.github.com - they can be secret or publicly available
  • You can send a pull request to the repository for proof of concept
  • If you want to discuss a pull request against an upstream repository, DevCentral allows "free" diff not linked to any repo too: diff/create

Too many tools! I'm lost

It can require some practice to be able to pick among the most appropriate tool, so you can start with:

• Command output -> command | nc termbin.com 9999
• Anything else
  • Ephemeral -> https://dpaste.com/
  • To save and discuss in tasks -> https://devcentral.nasqueron.org/paste/edit/form/default/