HomePage de um Projeto
Aqui vemos sugestões de sessões para uma página de projeto AWA. (Publicado inicialmente no Wiki do Projeto AWA, que está sendo desativado)
Homepage
- Descrição inicial do projeto
- Um screenshot da aplicação
- Uma sessão de notícias, caso possível
Features
Coloque todos os recursos já implementados, e possivelmente também a sua lista de recursos a desenvolver.
Como Instalar
Liste tudo o que é necessário para se utilizar da sua aplicação (os pré-requisitos).
Coloque um passo a passo de instalação.
Licença
É importante deixar na página, em um ponto claro, a licença sob a qual o projeto está sendo liberado.
Screenshots
É importantíssimo mostrar como a aplicação se parece no final. Para isso, utilize-se de screenshots. Se possível, será ainda melhor dispor de um demo do seu sistema rodando.
Neste caso, tenha cuidado com a consistência e com o banco: em muitos casos convém resetar o banco automaticamente, de tempos em tempos.
FAQ
Aproveite os questionamentos que lhe fizerem a respeito da aplicação, pessoalmente ou por mail, e os agrupe em uma lista de perguntas mais freqüentes.
Devel
Divulgue a forma como a aplicação é feita para facilitar colaborações: a arquitetura, as técnicas adotadas e como participar.
Se utilizou algum sistema de documentação automática, você pode dispor de um link para essa documentação aqui também.
Se houver lista de discussão ou fórum para o seu projeto, divulgue-os aqui, ou em uma sessão Comunidade.
Outras coisas
Se você está utilizando os serviços de algum repositório de projetos, não se esqueça de fazer referência ao seu projeto no repositório, pois lá haverá outras informações disponíveis ao público: mantenha esses dados atualizados!
Não se esqueça do link para Download.
Utilize outros recursos como desejar: shoutbox, comentários, aplicação blog, CMS, wiki, guestbook... Mas o básico já deve dar conta. Só tenha cuidado na organização dos ítens em menus, para que não fiquem confusos ou cheios demais.
Divulgue seu projeto em sites de notícias da comunidade sempre que tiver uma nova versão importante.
-- Cárlisson Galdino
Tags: awa - Visits: 109 - No Comments
AWA - O Guia
Agradeço principalmente aos meus pais Erluce e Cícero por terem me apoiado sempre, desde o curso de graduação (este trabalho foi inicialmente desenvolvido para ser apresentado à conclusão do curso semi-presencial de especialização Produção de Software (com ênfase em Software Livre), cursado da UFLA) e, agora, neste curso à distância.
Agradeço também o apoio e amizade dos colegas de curso, mesmo pouco nos conhecendo pessoalmente. Em especial, ao conterrâneo Alex e ao goiano Aramis, parceiros de todos os trabalhos, com quem mantenho mais contato desde o início do curso. Ao quadro de professores nas pessoas da professora Ângela, sempre presente e atualizada, da professora Ana Cristina e de Alan Kelon, pelo apoio na orientação.
Um agradecimento à comunidade Mozilla Brasil pelos bons momentos no projeto, apesar de todas as intempéries (que até hoje perduram, mas que estão começando a se resolver), ao pessoal da Univates que mantém o portal Código Livre, apenas para apoiar a comunidade nacional de desenvolvedores de Software Livre. Aos PSLs, aos programadores, documentadores, artistas, tradutores e divulgadores do Software Livre em nosso país e no mundo.
Enfim, a todos que lutam por tornar o mundo um local mais justo, com mais padrões abertos e alternativas tecnológicas e menos monopólios.
-- Cárlisson Galdino
Tags: awa - Visits: 93 - No Comments
A Importância do Texto Plano
Artigo escrito inicialmente em 21/04/2006
Bom, vou arrumar um canto ainda no rascunho do TCC pra colocar isso e, como é um ponto importante, vou colocar aqui no blog como uma anotação por enquanto...
Tudo relacionado a Reis2003, neste caso lá pela página 41.
A comunidade em torno de um projeto de software livre usa a Internet como ferramenta. Usa, desta forma, correio eletrônico, páginas web, listas de discussão e ferramentas como sistema de controle de versões, e controle de falhas.
O trabalho de Reis2003 não cita (ao menos neste ponto), mas Wiki também vem sendo muito usado para manter documentação, e blogs em alguns casos.
No caso de listas de discussão, por exemplo, a forma de envio é sempre texto plano, nada de HTML.
"Normalmente o conteúdo transmitido por estes meios será texto simples, escrito na grande maioria dos casos em inglês. A comunidade de software livre tende a não utilizar e-mail HTML, por exemplo. Muitas pessoas têm habilidade de formatação bastante avançada, usando recursos como hierarquização, listas e até diagramas criados usando símbolos texto. A figura 4.1, por exemplo, demonstra o uso de uma mensagem de correio eletrônico para descrever uma interface gráfica. O uso do denominador comum texto garante acesso ao conteúdo, não importando qual ferramenta de visualização é utilizada."
É exatamente isso o que acontece. E é exatamente por isso que pretendo fazer do AWA um processo que use apenas ASCII como forma de expressar o que for preciso.
Ah, pra quem ficou curioso com a tal figura 4.1, é algo simples. Só uso de barras verticais e horizontais, texto e outros caracteres para definir um leiaute de janela. Se quiser mesmo ver, clique no link para Reis2003, abra o PDF e vá pra página 42.
Aproveitando, foi definida a minha orientação. Será Ana Cristina Rouiller.
Tags: awa - Visits: 85 - No Comments
O que é um Metaprojeto de Software Livre?
Artigo escrito inicialmente em 20/04/2006
Achei Reis2003 e certamente vai ser uma das fontes bibliográficas mais interessantes para o trabalho.
Sua definição de Projeto de Software Livre:
"Organização composta por conjunto de pessoas que usa e desenvolve um único software livre, contribuindo para uma base comum de código-fonte e conhecimento. Este grupo terá à sua disposição ferramentas de comunicação e trabalho colaborativo, e um conjunto de experiências e opiniões técnicas que usam para discutir o andamento do projeto."
E continua dizendo que projeto de software livre pode ser usado para definir também:
- Meta-projeto: que é um agregado de projetos relacionados, como ocorre com o KDE, o Gnome, o Mozilla e o Apache, por exemplo. Geralmente é organizado por líderes dos projetos mais fortes que integram o meta-projeto.
- Distribuição: conjunto de pacotes, que podem estão relacionados em termos de uso, não de desenvolvimento. Enquanto o meta-projeto objetiva garantir infra-estrutura e apoio para as equipes, a distribuição se preocupa com o usuário final.
- Grupo de usuários: geralmente formado com algum vínculo geográfico, objetiva ajudar novos usuários, promover o uso do software na região do grupo e dar suporte básico a usuários. Geralmente seus membros trocam experiências de uso e tiram dúvidas entre si.
É ou não é uma boa visão da coisa? :-)
----
Append 1
Um software livre está, na grande maioria dos casos, disponível em um repositório que controla versões, de modo que qualquer um possa modificá-lo. Porém, não é qualquer um que pode consolidar as modificações. Para isso, é necessário recorrer a um mantenedor (são poucos por projeto, muitas vezes um só), para que este aplique os patchs. Tenho que falar disso em algum momento também...
Tags: awa - Visits: 79 - No Comments
Atomic Web Applications
Artigo escrito inicialmente em 12/04/2006
Motivação
É crescente o número de Sistemas de Gerenciamento de Conteúdo disponíveis como FLOSS (Free/Libre Open Source Software). Além de clássicos como o PHP-Nuke, diversos têm aparecido, nas mais diversas linguagens de programação. Muitas empresas têm suas próprias centrais de sistemas, seja na forma de um portal com múltiplos recursos ou um serviço disponível apenas em ambiente de Intranet. Uma aplicação web atômica é um sistema web que foca um único problema bem-definido, e que pode ser usado tanto de maneira autônoma como na forma de um módulo acoplável a um Sistema de Gerenciamento de Conteúdo ou a uma Central de Sistemas.
Este processo independerá da linguagem de programação adotada.
Objetivos
Este trabalho pretende definir um processo que facilite a criação de aplicações web atômicas FLOSS. Objetiva-se que haja um aumento na qualidade dos projetos FLOSS desta categoria, bem como uma maior facilidade no melhoramento de Sistemas Gerenciadores de Conteúdo existentes, com o acréscimo de módulos.
AWA é um processo para criação de aplicações web atômicas.
Pretendo dividí-lo em 3 (três) partes fundamentais:
- Instruções de Arquitetura: regras de organização tanto dos arquivos quanto das funções, classes e variáveis de configuração. É importante porque para que uma aplicação web seja facilmente modularizável, precisamos de uma arquitetura feita para isso.
- Conjunto de boas práticas: boas práticas divididas em exigidas, recomendadas e sugeridas. Bem no estilo de eXtreme Programming. Esta parte, em especial, poderá ser utilizada também para a criação de aplicações web não atômicas.
- Processo de criação: este, já garanto de antemão que não terei tempo de testar até o dia de apresentação do TCC. Mas trata-se de um processo de software (passos a seguir no desenvolvimento), em uma proposta tão ousada quanto as acima citadas: evitar diagramas e preferir ASCII. Tentando capturar o espírito de desenvolvimento comunitário, o ASCII é uma decisão não só útil, mas necessária: e-mails devem ser mandados em ASCII, arquivos de controle ASCII podem ser colocados em CVS ou em um Wiki facilmente. %%% Os passos devem ser cíclicos e parecidos com XP, mas usando como controle principal uma todo list e uma feature list.
Tags: awa - Visits: 67 - No Comments