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

Avalie esse artigo

Relevância
Estilo/Redação

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
Feedback geral
Bugs
Publicidade
Editorial
Marketing
InfoQ Brasil e todo o seu conteúdo: todos os direitos reservados. © 2006-2016 C4Media Inc.
Política de privacidade
BT

We notice you’re using an ad blocker

We understand why you use ad blockers. However to keep InfoQ free we need your support. InfoQ will not provide your data to third parties without individual opt-in consent. We only work with advertisers relevant to our readers. Please consider whitelisting us.