Dicas de garantia de qualidade para o Portal do PSL-Brasil

A idéia é qualificarmos o Portal do PSL-Brasil, em primeiro lugar, e reativar o portal do PSL-RS. Para isso estou catando propostas de boas práticas sobre o assunto. Minha próxima tarefa é propor um conjunto de "regras" para definirmos quais noticias terão destaque ou não.

Daremos dicas relativas aos itens de garantia de qualidade preconizados pelas tecnologias do W3C? tais como HTML, CSS, HTTP.

Cada dica está sumariamente descrita em um texto que se constitui em link para uma explicação detalhada.

Dicas de garantia de qualidade

title: o elemento mais importante para a qualidade de um website?

Não use "Clique aqui" para texto de link

Use redirecionamento standard: nao tire a funcao do botao "back"?

Use h1 para os cabecalhos de primeiro nivel

Use o atributo alt

Nao esqueça do doctype em seu documento

Use link no seu documento

Se especificar cor, especifique para tudo?

Atencao com os tamanhos de fontes

Use formatação internacional para datas

GIF ou PNG

Use cabecalhos para estruturar seus documentos

Escolha criteriosamente suas URIs

Administrando as URIs

Alem da validacao

Nomeie classes semanticamente

Listas não ordenadas: mais do que marcadores?

Como escrever e propor uma dica

Qualquer um é bem-vindo para submeter uma nova dica para ser acrescentada a este documento.

1. Leia as dicas de garantia de qualidade que já foram submetidas. Se você achar que uma dica não está clara e desejar propor modificação, primeiro pesquise nas referências constantes da dica, pois pode ser que seu ponto de vista já tenha sido discutido.

2. Escreva sua proposta de dica de garantia de qualidade usando este twiki de dicas de garantia de qualidade. Basta colocar "Proposta do(a) fulano(a)."

Dicas para escrever dicas

Comece com um título simples e atrativo. O interesse das pessoas em ler a dica depende da motivação que o título desperta.

Qual é o objetivo da dica? Deixe logo no início e bem claro, qual é o objetivo da dica. Faça uma breve introdução e desperte a curiosidade das pessoas em continuar lendo.

... Antes de começar a descrever a dica lembre-se: seja conciso. Isto é difícil, porque você não tem idéia do contexto de onde vem seus leitores, escreva textos curtos.

As dicas são pequenas informações destinadas a fornecer subsídios complementares e esclarecer, elas não tem caráter normativo nem são especificações rigorosas a seguir. As dicas devem sugerir e justificar e nunca ter caráter impositivo ao leitor.

"Deve" pode ser usado em uma dica quando for uma transcrição de uma especificação normativa. Ao usar o termo "deve" em um texto, deixe bem claro tratar-se de uma citação, através de uma marcação apropriada (

, ). É de boa prática complementar uma citação normativa com explicações adicionais quando necessário.

É também uma boa prática, fazer referências a outros documentos que contenham textos correlatos ao da dica.

Coloque (não em demasia) no final da dica, referências com uma breve explicação, para documentos onde as pessoas possam aprofundar a leitura no assunto da dica.

Ao fazer referência a uma especificação normativa, explique os acrônimos ou escreva por extenso usando se possível, marcação apropriada.

Referências

Quality tips: ready for release? Dan Connolly (Fri, Sep 28 2001)

&sysreq chat 4Jun2001

webmaster/validator tip-of-the-day Date: Wed, 16 May 2001 12:16:31-0500 From: Dan Connolly

Dicas de garantia de qualidade para Webmasters

Esta é a tradução do artigo "Quality Tips for Webmasters " de autoria de Dan Connolly publicado no site do W3C?.

1. A versão oficial e original, em inglês, deste artigo, encontra-se em: http://www.w3.org/QA/Tips/ e os seus direitos são conforme:

Copyright ©2002 W3C?® (MIT, INRIA, Keio), Todos os direitos reservados. São aplicáveis as disposições do W3C? relativas a responsabilidade, marcas, uso de documentos e licença de software

2. A única versão oficial deste documento é a versão em língua inglesa que se encontra no sítio do W3C?.

3. O presente documento traduzido para a língua portuguesa do Brasil, pode conter erros de tradução.

Este documento foi traduzido em 02 de janeiro de 2005 por: Maurício Samy Silva e encontra-se hospedado no seu sítio "CSS para WebDesign?" em http://www.maujor.com/

A traduçao foi feita somente para este documento, vale dizer, as páginas remetidas pelos links aqui indicados, estão em sua versão original em língua inglesa. Excetuam-se os links para as 17 páginas com a descrição de cada uma das dicas, que também foram traduzidas. Naquelas páginas no menu de navegação à direita, você encontra um link nomeado "Índice das dicas" que aponta para esta página inicial.

********************

Foram feitas alterações para o nosso uso da ASL. (MarioTeza?) em 04/01/2005

Topic revision: r3 - 04 Jan 2005 - 14:51:03 - MarioTeza


Create personal sidebar

 
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Wiki-SL? Send feedback