Tree [07696a] master /
History



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