Não adianta

Já procurei por todo canto

não adianta

na melodia de luiz ela não se escondeu

pelo pagode de zeca ela não anda

A vila de martinho vasculhei

pela batida do pandeiro de jackson tentei chamar

onde se meteu, não sei

para tê-la de volta, até a viola de paulinho eu fiz chorar

chora viola de paulinho

canta um pagode, zeca pagodinho

pra ela voltar

eu trago martinho lá da vila

de luiz, canto uma melodia

pra ela voltar

não adianta

sem ela, emudeceu-se tudo que canta

nem implorando

tudo que gritava, agora anda susurrando

esperando ela voltar…

Tópico Frasal

Aprendi bastante com a revisão que meu orientador fez da minha dissertação. Sobretudo porque ele não alisou :)

Uma das lições que tirei é o uso de tópico frasal. Na verdade eu já sabia disso, sabia que era bom usar, tinha plena consciência de que melhora a leitura do texto, mas não estava usando.

Tópico frasal é uma sentença curta que resume o parágrafo. Um exemplo tirado da wikipedia:

Em 1986, os veículos a álcool chegaram a representar 98% da linha de produção. Os veículos a gasolina só eram disponíveis por encomenda. Devido a medidas na área financeira, a produção de carros a álcool hoje mal chega a 1% da frota nova. Os que restam a álcool estarão em uso por curto tempo. O programa foi exterminado.

A sacada é você apresentar a ideia do parágrafo para que o leitor se situe. Desse modo, ele saberá do que vai ser tratado logo no início do parágrafo.

Isso me remete àquele mesmo papo que discuti em um post anterior. Sobre não deixar o leitor na expectativa. Texto científico não é romance. O leitor não pode ficar curioso sobre o que vai acontecer.

Para mostrar que aprendi, e para que sirva de exemplo para quem precisar, vamos a um exemplo retirado da minha própria dissertação.

Antes estava assim:

"No contexto de arquitetura de software, várias atividades foram propostas para aplicar

o processo de verificação, isto é, checar se a implementação segue as decisões arquiteturais

previamente especificadas. O termo utilizado nessa área é verificação de conformidade."

Perceba que eu queria falar sobre verificação de conformidade, mas isso só apareceu no final do parágrafo. Quando chegou por lá, o leitor parecia que tinha corrido uma são silvestre piauiense.

Tópico frasal:

"Verificação de conformidade é um dos tipos de verificação de software.

"

A partir de então eu dissertaria sobre o assunto, sacou?

Bando de Brasileiros!

Uma coisa tem me incomodado bastante ultimamente. E não são as derrotas do meu time. O que tem me irritado é essa mania de "por que você não mora fora?". "Lá é seguro. Você pode usar seu mac de dentro do ônibus às 3 horas da manhã." Essa coisa bem médio-classista de ainda olhar pro leste como quem olha para o patrão. Admirando, invejando e copiando seu estilo de vida requintado. Essa mania de vender o fígado para passar as férias em Paris, e não conhecer a chapada diamantina ou o delta do parnaíba.

Pois bem, meus novos ídolos agora são os que colocam uma mochila nas costas e vão conhecer a américa latina. Esses são meus heróis porque olham para nós mesmos. Somos muito mais incas e astecas do que franceses ou ingleses. Somos porque temos a mesma história, derramamos quase a mesma litragem de sangue para manter nossa marca. Novos ídolos, não! Admiro faz tempo Martinho da Vila porque foi um dos poucos que foi à África aprender samba. Procurar gente da gente é o que faz a diferença entre brasileiros e euro-brasileiros.

Embora tenha vontade de conhecer Paris, eu pouco me importo com a Torre de Ferro que lá existe. Queria sim passear pelas ruas e becos franceses. Queria, porque é lá que cada um dos turistas deixam meio milímetro de sola de sapato e alguns Giga de experiências incríveis. Queria experimentar sua carne, seus entorpecentes e seu pão. Assim como faço por aqui. Portanto, enquanto aqui sobrar becos e botecos de esquina, não invejo quem mora além mar.

Sempre preferi a magia e obscuridade dos terreiros às catedrais de cartões postais européias. Eu gosto de amigos, gosto de gente. Fico ansioso quando num sábado está marcado aquela cerva na casa de algum dos meus marginais. Fico pensando "com que roupa eu vou pro samba que o arnesto me convidou". Gosto do pagode, do samba, de noel, de adoniran, da música brasileira. Ensaio piadas, afino o violão, tiro a poeira do cavaco, porque sei que vão gostar de me ouvir tocar. E vão cantar! Mesmo bêbados e descompassados. E sei que há hora pra começar, no entanto, não há para acabar. Sei que isso, por lá, não vou encontrar. Nem amigos verdadeiros, nem festas sem horário.

Ainda que pareça um grito policarpo ou de alguém que acha que o melhor do brasil é o brasileiro, corro esse risco. Sem botar banca, e sem querem fugir do que sou, é isso mesmo!

Isso que sou (que somos, mesmo que alguns não queiram). Um bucado de brasileiro que no DNA carrega sangue, suor e cerveja. E mesmo que você deseje a tranquilidade de andar com seu Macbook em uma lotação de um país desenvolvido, mesmo que você consiga, saiba, a miséria daqui não vai diminuir por isso. Essa é sempre a solução adotada por muitos para resolver o problema. Esconder ele. Empurrar para a periferia. Varrer pra de baixo do viaduto. Fugir num navio para que possa nunca mais ter contato com esse bando de brasileiro pobre e mal-educado. Vocês só me fazem lembrar a tal madame que João Gilberto jogou pedra, tal como o rebanho de tolos em Gêni de chico.

Vão. Mas, vão voltar. Com certeza. Vão voltar porque o que vai falar mais alto é o pedaço da língua que identifica um bom picado, uma moela e uma couve no alho. O que vai falar alto depois de um tempo é o que corre nas veias e formiga os pés, fazendo com que se movam em forma de samba. Seu bando de Brasileiros!

Não adianta

Já procurei por todo canto
mas não adianta
na melodia de luiz ela não se escondeu
pelo pagode de zeca ela não anda

A vila de martinho vasculhei
pela batida do pandeiro de jackson tentei chamar
onde se meteu, não sei
para tê-la de volta, até a viola de paulinho eu fiz chorar

não adianta
sem ela, emudeceu-se tudo que canta
nem implorando
tudo que gritava, agora anda susurrando
esperando ela voltar…

chora viola de paulinho
canta um pagode, zeca pagodinho
pra ela voltar

eu trago martinho lá da vila
de luiz, canto uma melodia
pra ela voltar

Branco no samba

Resolveu fazer samba
chamou a mulher de preta, morena, minha menina
saiu como malandro
descendo o morro e esbarrando em rima
calça branca, bem feita a bainha
passos leves, como quem tem os pés a meio metro do chão
sorriso fácil, ginga no corpo, apesar da pele cor de algodão

Brigou com a gaita
mas quem chorou foi o cavaco
deu no pandeiro com tanta força
que acordou o pessoal dos barracos

e todo mundo sambou
embora não fosse samba de preto velho,
teve gente que até gostou

e todo mundo sorriu
embora não fosse malandro pra isso
teve mulata casada que por ele perdia o juízo

e todo mundo cantou em coro,
o refrão descompassado
do sambista que não veio do morro.

Errata: Quantificando facilidade de uso

Me expressei mal em relação à métrica do post anterior.

Quando disse:

"eu faço uma comparação simples entre o número de métodos que o programador esperava que houvesse na API e o número de métodos que realmente estão lá."

Eu quis dizer: Eu contabilizo quantos dos métodos presentes no pseudocódigo estão na API. A medida é a API tem X% do que o cara espera. Ou seja, eu pego os métodos que ele gostaria que tivesse na API e vejo quantos deles estão presentes nela.

Quantificando facilidade de uso

Estou fazendo a avaliação de usabilidade de uma API. O método que estou seguindo é o "think aloud protocol for APIs" - um método baseado na avaliação de usabilidade de interfaces gráficas e que foi modificado para APIs.

Em linhas gerais, este método consiste em observar programadores durante o desenvolvimento de algumas tarefas que usam a API. A parte do Think Aloud é feita pelo programador. Ele verbaliza quais as dificuldades que encontra pelo caminho para escrever o código de determinada tarefa. Este método, portanto, suporta a avaliação qualitativa de APIs, pois a observação do comportamento do programador é uma de suas bases.

No entanto, como eu sempre gosto de extrair números das coisas que estou avaliando, acabei bolando uma métrica baseada na seguinte frase:

"It is the comparison between what developers expect and what the API provides that is interesting when evaluating the usability of an API" (Steven Clarck)

O que eu fiz foi pedir para que os programadores, sem conhecer a API, fizessem o pseudocodigo de determinada tarefa. A partir daí eu faço uma comparação simples entre o número de métodos que o programador esperava que houvesse na API e o número de métodos que realmente estão lá.

É uma métrica simples, mas acredito que podem tornar as coisas menos subjetivas.

Dessa maneira, acabo me aproveitando de todo o apoio do protocolo para avaliação subjetiva e ainda crio uma métrica que pode servir como resultado quantitativo.

O que acham?