How to communicate

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

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/