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
• A Look at the Design of Lua
• 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
  • Público-alvo
  • Estrutura
    • Resumo
  • Comentários
  • Pontos de atenção
  • Conteúdo relacionado

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

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