Adjust your Perspective
Most of us, when we start using ØMQ, come with mental models of how things "should" work, which are often wrong. If you come looking for specific solutions, you may be disappointed. If you have to 'force' ØMQ to work as you expect, you are using it wrong. Take your time, learn the tool, allow your mind to adjust, and then attack your problems from a fresh perspective. Start small, make it work minimally, expand as you discover the real problems you need to solve, and make nothing you do not immediately need.
Read the Guide
Chances are high that most of questions you'll have, for the first weeks you use ØMQ, are answered in detail in the Guide, so please read this essential handbook before asking for help. ØMQ is superficially simple but deeply profound, and takes time to properly know.
Check the FAQ and Tuning Guides
Many questions come up quite frequently, so we've collected the most common ones in our FAQ. Similarly, each Operating System has its own share of quirks so the Tuning Guide offers a few suggestions.
Talk to the ØMQ Community
If your app is losing messages, use the Problem Solver. When you stumble with things that aren't clear or don't work as you expect, ask for help. The ØMQ community is large, active, smart and quick to offer advice.
You will find them hanging out on the #zeromq channel on the freenode IRC network. To connect to the network, configure your IRC client to use the chat.freenode.net server. If you don't have an IRC client, we suggest you try X-Chat (Linux, Windows and others) or Colloquy (Mac OS X).
You'll also find ØMQ developers and users on the zeromq-dev mailing list. You might want to search the archives to see if your question was already asked.
When you have trouble or find a problem, please:
- Don't post code fragments greater than a few lines, but use a pastebin.
- Note the operating system, ØMQ version, and other relevant aspects.
- Make a minimal reproducible test case, removing every line of code that's not necessary.
Report an Issue
If you think you have found a reproducible bug in ØMQ, report and track the issue until you're satisfied it's resolved one way or another.
Submit a Patch
We submit patches to the zeromq-dev mailing list. Contributing to ØMQ explains how it works. If your patch is accepted you will get credit in the contributors file. You are responsible for tracking your patch and convincing the ØMQ maintainers to accept it.
Get Involved
There are many areas where you can join in ØMQ. One way to write example applications in your favourite languages and use these to enlighten others. If you are a C++ programmer with a taste for kernel code, read the ØMQ code and learn how it works. You can also contribute in many other ways. ØMQ is LGPL code.
