BT

Gerente da equipe Sandcastle desmente rumores sobre o término do projeto

por Abel Avram , traduzido por Douglas Masson em 28 Jan 2009 |

Para rejeitar quaisquer boatos sobre o término do projeto Sandcastle, Anand Raman, gerente da equipe dentro da divisão de desenvolvimento da Microsoft, postou uma atualização sobre o atual status do projeto. Sandcastle é uma ferramenta utilizada para gerar documentação estilo MSDN através de reflection sobre o código fonte de um projeto .NET.

O código fonte do Sandcastle foi disponibilizado em CodePlex, certa de 6 meses depois de protestos após o projeto ter sido postado sem o código fonte. Depois disso, Anand disse que sua equipe trabalhou em incluir a biblioteca MSDN com o VS 2008 SP1. Atualmente, seu plano é de disponibilizar umas séries de correções até o final de janeiro:

  • Eu não forneço um arquivo SLN para os projetos. Você poderia criar o seu próprio arquivo, mas seria mais conveniente fornecer uma na distribuição dos fontes.
  • No arquivo SLN criado anteriormente a partir de uma distribuição dos fontes, os usuários encontraram o seguinte quando tentaram executar o build desta maneira:
    • Cada projeto tem a informação de controle de fonte do TFS que não é válida para pessoas de fora da minha equipe. Isto será retirado da distribuição do fonte.
    • A maioria dos projetos especifica um forte nome chave que não existe no pacote. Os arquivos do projeto deverá desativar a assinatura ou uma imitação do key.snk deverá ser fornecida.
    • O projeto MoreComponents não compila, tem erros como "'Microsoft.Ddue.Tools.BuildComponent' que não contém um construtor que tem '1' argumento". Parece que este é um projeto não essencial e talvez não deva ser incluído em todos.
    • O projeto MrefBuilderStatic não compila, erros como "o tipo ou o nome do namespace 'RootFilter' não pode ser encontrado (vocês estão esquecendo alguma diretiva orientada ou uma referencia assembly? are you missing a using directive or an assembly reference?)". Eu removerei este projeto.
    • BuildAssemblerConsole referencia o projeto CommandLine em um path incorreto.
    • Os projetos BuildAssembler e BuildAssemblerConsole parecem ser duplicados e o BuildAssemblerConsole não compila.
  • Depois do unloading dos projetos problemáticos, usuários conseguem obter todo o built. Infelizmente, existem 115 avisos no build. Estes devem realmente ser arrumados como uma prática melhor.

  • Existem muitos avisos de Análise do Código (FxCop). Nós deveríamos dar um bom exemplo eliminando tais avisos do código que nos enviamos.

  • Existem muitos arquivos que pertencem ao build do sistema NT e deveria ser excluído da distribuição do fonte (makefile, makefile.inc, placefile, etc.).

Anand disse que a equipe vai se concentrar em um novo conjunto de funcionalidades e correções após o VS 2010 Beta 1 ser liberado:

1. Versão que nós iremos usar para enviar o .NET Framework 4.0

2. Suporte para a sintaxe do F#

3. XSD documenter

4. Atributos para suportar o visualizador Microsoft Help 3.

O Sandcastle está disponível sob a Microsoft Public License (Ms-PL).

Olá visitante

Você precisa cadastrar-se no InfoQ Brasil ou para enviar comentários. Há muitas vantagens em se cadastrar.

Obtenha o máximo da experiência do InfoQ Brasil.

Dê sua opinião

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão
Comentários da comunidade

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

HTML é permitido: a,b,br,blockquote,i,li,pre,u,ul,p

Receber mensagens dessa discussão

Dê sua opinião

Conteúdo educacional

Feedback geral
Bugs
Publicidade
Editorial
InfoQ Brasil e todo o seu conteúdo: todos os direitos reservados. © 2006-2014 C4Media Inc.
Política de privacidade
BT