Lu-a-Bá - O bê-a-bá de Lua para a comunidade lusófona

Bibliografia

Lua possui raízes acadêmicas. Portanto, não é incomum que haja artigos, simpósios e outros trabalhos acadêmicos cobrindo esse assunto.

Eles não são necessariamente guias de estudo, mas podem contribuir significativamente para se aprofundar em tópicos específicos, tanto da linguagem como da sua implementação, e portanto podem ajudar a construir uma compreensão mais abrangente do assunto.

Documentos

Os documentos a seguir são importantes fontes bibliográficas para o Lu-a-Bá, e boa parte do conteúdo apresentado foi construído com base neles.

Esses documentos não são parte do projeto Lu-a-Bá, e portanto não estão (necessariamente) sob a mesma licença.

Critérios para escolha dos documentos

Documentos adicionados à bibliografia devem, em primeiro lugar, ser documentos relevantes e confiáveis, e contribuir para uma melhor compreensão deste ambiente de desenvolvimento.

Todos eles devem estar acessíveis publicamente. A necessidade de cadastro, autenticação ou pagamento são considerados impeditivos para uso no projeto Lu-a-Bá. Documentos que precisem ser obtidos em formato impresso também não constam aqui.

Não que haja necessariamente um problema nessas características, e certamente muitos documentos que não estão na bibliografia do Lu-a-Bá poderão ser muito úteis para o seu estudo. Mas a proposta aqui é tornar a informação mais acessível, evitando o máximo possível impor quaisquer barreiras.

Mas afinal, o que consta nessa seção?

Além dos endereços eletrônicos para os documentos da bibliografia, que são listados na página de cada documento, a seguinte estrutura é criada para cada um deles:

Título, metadados e breve descrição

Essa é a seção inicial, que informa o título do documento abordado, alguns metadados e uma breve descrição. Os metadados são:

A descrição deve oferecer um contexto geral do documento (como para qual finalidade foi criado, qual foi o seu público-alvo, em que contexto foi apresentado ou por que pessoa ou projeto foi preparado).

Público-alvo

Como implica o nome, essa seção serve para determinar qual será o principal público interessado no material e quais são alguns conhecimentos que se espera que esse público possua previamente para tirar maior proveito da leitura.

Estrutura

Essa seção enumera os tópicos da estrutura principal do documento, divida em capítulos ou seções, a depender do tipo de documento.

Resumo

Uma subseção da seção de estrutura, a qual detalha um pouco mais cada um dos tópicos enumerados, mostrando a progressão do conteúdo e a linha de raciocínio utilizada no documento.

Comentários

A principal função dessa seção é pavimentar o caminho para o leitor, isto é, permitir que ele extraia o máximo da leitura do documento, quando o fizer, ou que consiga posteriormente fazer uma releitura, caso já tenha lido o documento antes, possivelmente com uma nova percepção sobre o assunto.

Pontos de atenção

Os itens desta seção tratam majoritariamente sobre detalhes do documento que não são válidos para versões mais recentes de Lua, e também sobre alguns pequenos erros de digitação que eventualmente possam dificultar o entendimento de algum conceito abordado.

Vez ou outra podem incluir alertas sobre algum assunto que não fazia parte do escopo do documento, mas possui relação e pode ser de interesse do leitor.

Conteúdo relacionado

Assim como em outras seções do Lu-a-Bá, na bibliografia a seção de conteúdo relacionado aponta outros documentos do próprio Lu-a-Bá que possuem relação com o tema abordado.

Neste caso, serão apontados termos do glossário que foram abordados no documento, tutoriais relacionados e demais documentos do Lu-a-Bá que de algum modo possam contribuir para a compreensão do material em análise.