File	Date	Author	Commit
old	2011-07-28	Vilson Vieira	[45b1ca] renaming files appropriatelly
omniscientAA	2012-04-11	rfabbri	[66ae0b] terminada versao zero do AA omnisciente
.gitignore	2011-07-28	M. Quasar	[9e5ce0] Merge pull request #3 from mquasar/master
COPYING	2011-09-11	Andres MRM	[a2f91b] Merge branch 'master' of ssh://labmacambira.git...
FAQ	2013-01-02	Ricardo Fabbri	[d1ee6d] FAQ added, with item on espeak slowness
README	2013-01-01	Ricardo Fabbri	[3b68d2] last url nigthsc -> pp
README_AAPP	2011-08-25	Alexandre Negrão	[dcdb37] corrected package name
README_OMNISCIENT	2012-06-28	rfabbri	[833a14] pequena adicao sobre o AA Omniciente
TODO	2012-04-20	rfabbri	[a37560] adicionado item no TODO
aa-what-is-aa	2012-04-06	Ricardo Fabbri	[a104fb] description from an IRC chat of what is aa?
aa.py	2013-01-02	Ricardo Fabbri	[07696a] daemon now outputs to /tmp/aa.stdout and /tmp/a...
aapp.py	2011-09-13	Andres MRM	[771b67] tirando texto de debug
dump20120628.sql.tar.gz	2012-06-28	rfabbri	[342aa9] adicionado dum do bd de hj
janela.glade	2011-09-11	Andres MRM	[a2f91b] Merge branch 'master' of ssh://labmacambira.git...
janelinha.glade	2011-08-23	Andres MRM	[16e89a] resurrect e atalho

Read Me

oooOoOo[ AA ]oOoOooo
====================

What is AA? Read the file aa-what-is-aa for one way to look at it.

Installing
==========

Put aa.py on your /usr/local/bin:

    $ sudo cp aa.py /usr/local/bin/aa

Or just create a link:

    $ sudo ln -s /complete/path/to/your/aa.py /usr/local/bin/aa

Configure your nickname:

    $ aa config user.nickname <YOUR NICKNAME HERE>

And the AA-Web (the web server) URL:

    $ aa config server.url http://www.pulapirata.com/skills/aa/parser.php

Install dependencies:

    $ sudo apt-get install libnotify-bin espeak

Usage
=====

Now you can use:

    $ aa start                        ... starts your session
    $ aa post foo                     ... posts foo
    $ aa shout foo                    ... posts foo and sends message to server
    $ aa stop                         ... stops your session
    $ aa config <attribute> <value>   ... sets some attribute
    $ aa status|st                    ... checks if daemon is running
    $ aa time|ts                      ... show time and timeslot info
    $ aa viewlog                      ... shows your current log
    $ aa push                         ... pushes your log to the server

For now, just 'aa stop' will send your 'work log' to the server. You
can see your log at http://www.pulapirata.com/skills/aa (or any server configured using
aa config server.url <URL SERVER HERE>).

We suggest to shortcut aa shout to a simpler name such as 'as', since it is used
very often:

  echo 'alias as="aa shout"'  >> ~/.bashrc

Configuring
===========

Configuration attributes currently in use:

    user.nickname
    user.email
    user.tick
    server.url

Suggested Workflow
==================

A suggestion for your daily workflow on Lab Macambira:

* Look at the tickets of your GT on https://sourceforge.net/apps/trac/labmacambira
    aa tickets
    aa showticket <ticket number>
* Use AA
    aa start
    aa shout working on foo
    aa stop
    aa push
* Use '''shout''' instead of '''post''' when you are connected to the Web
* Open how many tickets your consider necessary to organize your actions
* Keep atention to your GT milestones
* Close the tickets you'll fixing
* Use the wiki a lot to report your activities: http://wiki.nosdigitais.teia.org.br/Lab_Macambira
* Use the mail list (listamacambira@teia.org.br) and IRC (#labmacambira at irc.freenode.net)

Contributing
============

If you don't have permission as developer on the AA's SourceForge project,
please send an email asking to labmacambira@teia.org.br.

If you have permission, clone the repos:

    git clone ssh://USERNAME@labmacambira.git.sourceforge.net/gitroot/labmacambira/aa

Change USERNAME by your SourceForge username.

For more information, take a look at http://wiki.nosdigitais.teia.org.br/Manual_do_Novato.