1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/project/get-help.md
Mike Brown 82fce53103 addressing useability comments per @moxiegirl
Signed-off-by: Mike Brown <brownwm@us.ibm.com>
2015-09-09 14:59:30 -05:00

7.4 KiB

Where to chat or get help

There are several communications channels you can use to chat with Docker community members and developers.

Internet Relay Chat (IRC)

IRC a direct line to our most knowledgeable Docker users. The #docker and #docker-dev group on chat.freenode.net. IRC was first created in 1988. So, it is a rich chat protocol but it can overwhelm new users. You can search our chat archives.

Use our IRC quickstart guide below for easy ways to get started with IRC.
Google Groups There are two groups. Docker-user is for people using Docker containers. The docker-dev group is for contributors and other people contributing to the Docker project.
Twitter You can follow Docker's twitter to get updates on our products. You can also tweet us questions or just share blogs or stories.
Stack Overflow Stack Overflow has over 7000K Docker questions listed. We regularly monitor Docker questions and so do many other knowledgeable Docker users.

IRC Quickstart

The following instructions show you how to register with two web based IRC tools. Use one illustrated here or find another. While these instructions are only for two IRC web clients there are many IRC Clients available on most platforms.

Webchat

Using Webchat from Freenode.net is a quick and easy way to get chatting. To register:

  1. In your browser open https://webchat.freenode.net

    Login to webchat screen

  2. Fill out the form.

    Nickname The short name you want to be known as on IRC chat channels.
    Channels #docker
    reCAPTCHA Use the value provided.
  3. Click on the "Connect" button.

    The browser connects you to Webchat. You'll see a lot of text. At the bottom of the Webchat web page is a command line bar. Just above the command line bar a message is shown asking you to register.

    Registration needed screen

  4. Register your nickname by entering the following command in the command line bar:

     /msg NickServ REGISTER yourpassword youremail@example.com
    

    Registering screen

    This command line bar is also the entry field that you will use for entering chat messages into IRC chat channels after you have registered and joined a chat channel.

    After entering the REGISTER command, an email is sent to the email address that you provided. This email will contain instructions for completing your registration.

  5. Open your email client and look for the email.

    Login screen

  6. Back in the browser, complete the registration according to the email by entering the following command into the webchat command line bar:

     /msg NickServ VERIFY REGISTER yournickname somecode
    

    Your nickname is now registered to chat on freenode.net.

Jump ahead to tips to join a docker channel and start chatting

IRCCloud

IRCCloud is a web-based IRC client service that is hosted in the cloud. This is a Freemium product, meaning the free version is limited and you can pay for more features. To use IRCCloud:

  1. Select the following link: Join the #docker channel on chat.freenode.net

    The following web page is displayed in your browser:

    IRCCloud Register screen

  2. If this is your first time using IRCCloud enter a valid email address in the form. People who have already registered with IRCCloud can select the "sign in here" link. Additionally, people who are already registered with IRCCloud may have a cookie stored on their web browser that enables a quick start "let's go" link to be shown instead of the above form. In this case just select the "let's go" link and jump ahead to start chatting

  3. After entering your email address in the form, check your email for an invite from IRCCloud and follow the instructions provided in the email.

  4. After following the instructions in your email you should have an IRCCloud Client web page in your browser:

    IRCCloud

    The message shown above may appear indicating that you need to register your nickname.

  5. To register your nickname enter the following message into the command line bar at the bottom of the IRCCloud Client:

     /msg NickServ REGISTER yourpassword youremail@example.com
    

    This command line bar is for chatting and entering in IRC commands.

  6. Check your email for an invite to freenode.net:

    Login screen

  7. Back in the browser, complete the registration according to the email.

     /msg NickServ VERIFY REGISTER yournickname somecode
    

Tips

The procedures in this section apply to both IRC clients.

Set a nickname

Next time you return to log into chat, you may need to re-enter your password on the command line using this command:

  /msg NickServ identify <password>

With Webchat if you forget or lose your password see the FAQ on freenode.net to learn how to recover it.

Join a Docker Channel

Join the #docker group using the following command in the command line bar of your IRC Client:

    /j #docker

You can also join the #docker-dev group:

    /j #docker-dev

Start chatting

To ask questions to the group just type messages in the command line bar:

Web Chat Screen

Learning more about IRC

This quickstart was meant to get you up and into IRC very quickly. If you find IRC useful there is more to learn. Drupal, another open source project, has written some documentation about using IRC for their project (thanks Drupal!).