How to communicate: Difference between revisions

From Nasqueron Agora
Dereckson (talk | contribs)
Bureaucrats, core, Interface administrators, Administrators
2,026 edits
Created page with "== 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 ** [https://termbin.com/ Termbin]: <code>command | nc termbin.com 9999</code> ** Arcanist to pu..."
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
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:
{| class="wikitable"
|+ Primary discussion spaces
|-
! Space !! How to join !! Scope
|-
| [[IRC]] || [https://libera.chat/ Libera.chat] #nasqueron-ops || Discussions about servers, infrastructure, operations, access.<br>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! [https://forms.nasqueron.org/nasqueron-requests/agora-account/new 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:
{| class="wikitable"
|+ Known discussion spaces
|-
! Space !! How to join !! Scope
|-
|-
| Discord || https://discord.gg/DZQK8Dd8Xd || ServPulse
|-
| Jitsi || https://meet.jit.si/nasqueron || Any topic.<br>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 ==
== Share logs, screenshots ==
;Core recommandations
;Core recommandations
* DO: use appropriate tools to share information through a short link
* DO: use appropriate tools to share information through a short link
Line 26: Line 65:
** Ephemeral -> https://dpaste.com/
** Ephemeral -> https://dpaste.com/
** To save and discuss in tasks -> https://devcentral.nasqueron.org/paste/edit/form/default/
** To save and discuss in tasks -> https://devcentral.nasqueron.org/paste/edit/form/default/
[[Category:Contributor guide]]
[[Category:Reference guide]]

Latest revision as of 21:09, 11 February 2026

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:

Retrieved from "https://agora.nasqueron.org/index.php?title=How_to_communicate&oldid=2243"