Fedora Talk User Cases

This page is intended to be a comprehensive list of all the things a User might want to do with FedoraTalk. A separate page holds things a Facilitator or Adminstrator might need to do. These use cases are developed as part of the FAD Fedora Talk 2009 game plan.
 * If it is works today, there should be a link to a wiki page explaining how to do it
 * If it doesn't exist to day, there should be a link to an Ticket with a keyword of ftalk.

Configure Soft Phone
Sally would like to connect to Fedora talk, but she has no IP telephone. She decides to use a softphone (a software program on her Linux PC that emulates a phone) to connect to Fedora Talk


 * 1) Install a soft phone package
 * 2) Configure said soft phone
 * 3) Test newly configured phone

LINKS:
 * Suitable soft phones in Fedora repo
 * Separate pages for each soft phone
 * Ekiga: https://fedorahosted.org/fedora-infrastructure/ticket/1723 -- http://talk.fedoraproject.org/client-ekiga
 * Twinkle: https://fedorahosted.org/fedora-infrastructure/ticket/1751 -- http://talk.fedoraproject.org/client-twinkle
 * Empathy: https://fedorahosted.org/fedora-infrastructure/ticket/1752 -- http://talk.fedoraproject.org/client-empathy

Configure Hard Phone

 * 1) Identify your hard phone or obtain one <>
 * 2) Follow configuration steps for your hard phone
 * 3) Test newly configured phone

LINKS:
 * Suitable hard phones that will work with FedoraTalk and are not too difficult to configure
 * Separate pages for each hard phone

PLAN:
 * After discussing more at the FAD on 2009-10-24 we decided that there are too many different hard phones to provide instructions for. Our proposed solution at this time is to have these pages be self-service on the wiki.  We have a link to this wiki page from the talk.fedoraproject.org page.
 * https://fedorahosted.org/fedora-infrastructure/ticket/672

Testing a Newly Configured Phone
Rodrigo has a phone (either soft or hard phone) configured to communicate with Fedora Talk, and wants to ensure that everything is working correctly.


 * 1) Rodrigo authenticates with FedoraTalk from their softphone or hard phone
 * 2) Rodrigo places a call to extension 1001 to test incoming audio.  Rodrigo should hear the lyrics to the song "Louie, Louie"
 * 3) Rodrigo places a call to extension 1002 to test outbound audio.  Fedora Talk echoes back any audio that Rodrigo speaks into his microphone.  Rodrigo should hear the return audio.
 * 4) Rodrigo places a call to extension 1003.  Rodrigo will hear either a short announcement or a warbling sound.  After hanging up the phone, Fedora Talk should call Rodrigo back on his phone.
 * 5) Rodrigo places a call to extension 1000 to hear the Fedora Talk welcome message.
 * 6) Rodrigo logs into Fedora Community and checks to see that his phone shows as being registered.

LINKS:
 * http://talk.fedoraproject.org/troubleshooting.hml
 * https://fedorahosted.org/fedora-infrastructure/ticket/1762

Make a Simple Call With Softphone
A Fedora community member wants to call another Fedora community member using a soft phone


 * 1) John has a USB headset and wants to call Rudolph, another FedoraTalk member.
 * 2) John installs Twinkle
 * 3) John configures Twinkle - http://talk.fedoraproject.org/client-twinkle
 * 4) John calls Rudolph by calling the number Rudolph provides or by Rudolph's FAS user name

LINK: http://talk.fedoraproject.org/verify

Make a Simple Call From a Regular Telephone
A Fedora community member wants to call another Fedora community member using a regular telephone


 * 1) Call one of the direct dial in numbers
 * 2) Enter the extension or conference room you wish to reach
 * 3) If you aren't sure which extension to call use the name directory at the prompt

LINKS:
 * https://fedorahosted.org/fedora-infrastructure/ticket/1763
 * http://talk.fedoraproject.org/ (once updated)

Looking up a Phone Number
Rosa wants to call Rhonda, but doesn't know Rhonda's extension or FAS user name.

There are a few ways to do this... some more straightforward than others.
 * 1) Using zodbot .ext 
 * 2) Call someone directly using their FAS Username
 * 3) Call into Fedora Talk using a direct dial in number < > from a regular phone and select the directory option.  You can also call extension 1000 from a softphone.

LINKS:
 * Docs--FIXME
 * Fix Asterisk Config for directory lookup--https://fedorahosted.org/fedora-infrastructure/ticket/1758#preview
 * Add go back option to Directory extension https://fedorahosted.org/fedora-infrastructure/ticket/1759 (Wishlist)

Record own name for directory
A Fedora community member wishes to use the directory to call someone but doesn't want to listen to the Allison Smith spell everybody's names. This can be helped by letting people record their names and uploading them through FAS.

LINK: FIXME -- file a ticket in Infrastructure

Receive a Simple Call
A Fedora community member would like to receive a call another Fedora community member
 * 1) Configure phone to accept call
 * 2) Configure softphone
 * 3) Configure hardphone
 * 4) Authenticate with FedoraTalk
 * 5) Wait for call
 * 6) Answer call

LINK: Multiple documentation pages http://talk.fedoraproject.org/access

Forward calls to their sip/asterisk server
A fedora member would like calls to their Fedora account to go to their sip/asterisk server for smart handling (such as further forwarding to different locations based on time of day). Rather than having their server poll Fedora Talk (to maintain their registration) it would probably be more efficient to use forwarding.
 * 1) Configure their fedora talk config to forward calls using sip/iax

LINK: https://fedorahosted.org/fedora-infrastructure/ticket/1764

Listen to a Live Conference (not participate)
A group of people is participating in a call or streaming a call from a live event. Fedora community members would like to listen to the call


 * 1) User decides how to conenct to conference
 * 2) Web streaming
 * 3) Softphone
 * 4) Hardphone
 * 5) User connects to conference

LINKS:
 * No need for special end user documentation because participants will get instructions from meeting facilitator
 * https://fedorahosted.org/fedora-infrastructure/ticket/453
 * https://fedorahosted.org/fedora-infrastructure/ticket/395

Participate in a Live Conference
A group of people is participating in a call or streaming a call from a live event. Fedora community members would like to listen and participate in the call.


 * 1) User configures phone
 * 2) User authenticates with FedoraTalk
 * 3) User conencts to conference
 * 4) User enters conference code

LINK:
 * No need for special end user documentation because participants will get instructions from meeting facilitator.
 * Other Infrastructure tickets cover the actual implementation.

Retrieve previously recorded meeting
Nancy missed the board meeting last week and wants to listen to the meeting


 * 1) Nancy goes to ${URL}
 * 2) Nancy downloads audio file
 * 3) Nancy listens to audio file locally

LINK:
 * No need for special end user documentation because participants will get instructions from meeting facilitator.
 * Other Infrastructure tickets cover the actual implementation.

= Open Questions =
 * 1) In cases of public conferences, can/should we further restrict codec use to promote the lowest possible bandwidth per caller?  Or is this a dynamic feature that the Asterisk server and clients manage automatically as call numbers grow? --pfrields 11:21, 16 October 2009 (UTC)
 * 2) * My (Bruno) memory is that it is better for everyone in a conference to be using the same codecs. But one of the real Asterisk guys might understand this better.
 * 3) * Some of the better/best codecs are patented and we may not be able to use them.
 * 4) ** Our Asterisk instance supports GSM, fallback to uLaw, fallback to aLaw. We will attempt to support the widest possible range of clients at the lowest possible bandwidth per client. This is not dynamically adjustable by the server but will be tuned as a matter of course by the infrastructure team, using free codecs of course.
 * 5) Add yours today :-)