Curadoria

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 passaram pelo processo de curadoria. É importante dizer que os documentos curados, propriamente, não são parte do projeto Lu-a-Bá, e portanto não estão (necessariamente) sob a mesma licença.

• A Linguagem Lua e suas aplicações em Jogos
• Lua – Conceitos Básicos e API C
• The Evolution of Lua
• Uma introdução à programação em Lua

Por que fazer essa curadoria

Documentos desta natureza são atrelados à sua época, isto é, não cobrem mudanças que venham a ocorrer depois da sua publicação, e neste sentido a sua leitura precisa ser contextualizada para evitar que o leitor perca o rastro das mudanças ocorridas até o momento presente.

A curadoria realizada no projeto Lu-a-Bá seleciona documentos que poderão contribuir para o aprendizado da linguagem Lua, sua API C e sua implementação padrão e faz essa contextualização temporal. Isso contribui não apenas para leitores que queiram utilizar esses documentos como parte do seu estudo, mas também para o próprio projeto, que então se respalda sobre fontes confiáveis.

Para além de trabalhos acadêmicos, outros documentos que eventualmente tratem sobre Lua, contribuam para o estudo e estejam também atrelados a uma época específica (tais como livros e apostilas, por exemplo), o projeto também os cobrirá, dentro do possível.

Critérios para escolha dos documentos

Documentos que passam por esse processo devem, em primeiro lugar, ser documentos relevantes e confiáveis, e contribuir para uma melhor compreensão deste ambiente de desenvolvimento.

Todos os documentos curados devem estar acessíveis publicamente. Isso não abrange, portanto, documentos que estejam armazenados em sistemas que exijam cadastro e autenticação, documentos que só podem ser obtidos em forma impressa ou que possuam qualquer forma de tarifação.

O projeto Lu-a-Bá não condena essas formas de publicação (pelo contrário, endossa a leitura complementar com esses materiais, quando possível), porém se propõe a ser um projeto inclusivo. O acesso a um dispositivo eletrônico com acesso a Internet já pode ser uma barreira por si só, e portanto barreiras adicionais para acesso ao conteúdo são evitadas.

Como é feita a curadoria

O processo de curadoria desses materiais deve dar como resultado um documento com a estrutura a seguir.

• Título do documento, metadados e breve descrição
  • Estrutura
    • Resumo
  • Comentários
  • Pontos de atenção

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:

• Ano: ano em que o documento foi publicado;
• Idioma: idioma em que o documento foi escrito;
• Baixar/acessar: endereço para acesso ao documento, informando o formato em que foi disponibilizado (PDF, HTML, etc).

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).

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.

Para isto, devem ser apontados públicos-alvo que mais se beneficiarão do documento, possíveis barreiras para outros públicos e informações complementares que possam ser de interesse.

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.