Recentemente, tenho trabalhado na refatoração de partes da base de código com a qual estou lidando atualmente - não apenas para entender melhor, mas também para facilitar para outras pessoas que estão trabalhando no código. Costumo me apoiar no lado de pensar que o código de auto-documentação é...
Suponha que você seja o único desenvolvedor a deixar um emprego. Que tipo de informação / material, fora do próprio código, você deve criar e deixar para sua substituição? Uma resposta óbvia é "o que você deseja em um novo emprego", com certeza, mas já faz um tempo desde que eu comecei um novo...
Um dos desenvolvedores da minha equipe acredita que é necessário escrever um comentário javadoc para TODOS os parâmetros na assinatura de um método. Não acho que isso seja necessário e, de fato, acho que pode até ser prejudicial. Primeiro, acho que os nomes dos parâmetros devem ser descritivos e...
Todos nós já vimos inúmeros exemplos de software que são fornecidos com "requisitos mínimos de sistema", como os seguintes: Windows XP / Vista / 7 1GB RAM 200 MB de armazenamento Como são geralmente determinados? Obviamente, às vezes há restrições específicas (se o programa ocupa 200 MB no...
Estive estudando como documentar projetos de software de maneira mais formal e aprendi sobre o IEEE 830-1998: Prática recomendada para especificações de requisitos de software . No entanto, como você pode ver nesse link, ele foi substituído. Eu sei que 830-1998, e provavelmente até 830-1993,...
Eu realmente gosto de design de linguagem de programação. Às vezes, acho que meus projetos de idiomas e seus usuários em potencial se beneficiariam de um documento abrangente sobre padrões. Examinei muitos padrões de linguagem, desde o formal (C ++) até o informal (ECMAScript), mas não consigo...
Fechadas. Esta questão está fora de tópico . No momento, não está aceitando respostas. Deseja melhorar esta pergunta? Atualize a pergunta para que ela esteja no tópico do Software Engineering Stack Exchange. Fechado há 6 anos . Estou procurando um...
Estou trabalhando em um produto para um cliente que deve ser válido e adequado à finalidade. Ele é construído em uma pilha LAMP (PHP / Cake), então há licenças GPL, MIT, PHP, APACHE: "TAL COMO ESTÁ", SEM GARANTIAS OU CONDIÇÕES DE QUALQUER TIPO, expressas ou implícitas, incluindo, sem limitação,...
Se JSON significa JavaScript Object Notation, quando você diz JSON, não está realmente dizendo "JavaScript Object Notation Object"? Dizer "string JSON" seria mais correto? Ou seria mais correto simplesmente dizer JSON? (como em "Esses dois serviços transmitem JSON entre
Atualmente, estou trabalhando com um professor da minha universidade para desenvolver novos currículos para os cursos de Engenharia de Software e Design Capstone oferecidos em minha faculdade. Até recentemente, os dois cursos usavam exclusivamente o modelo em cascata e, portanto, os alunos...
Tenho algumas perguntas sobre como escrever uma especificação e elas são: Quando escrevemos uma especificação de software, no tópico "Definição de requisitos do usuário", precisamos especificar apenas as "Funções" e "Restrições"? "Interface do usuário" se enquadra em "funções" ou...
Quanta documentação técnica (para futuros desenvolvedores) é suficiente ? Existe uma proporção entre horas de codificação e horas de documentação que é apropriada? Papadimoulis argumenta que você deveria produzir a menor quantidade de documentação necessária para facilitar o maior...
Eu trabalho em uma empresa de sistemas de controle, onde o trabalho principal é SCADA e PLC , juntamente com outras coisas de sistemas de controle. O desenvolvimento de software não é realmente algo que a empresa faz, além de pequenos detalhes aqui e ali, até que houve uma decisão de criar um...
Fechado . Esta questão precisa ser mais focada . No momento, não está aceitando respostas. Deseja melhorar esta pergunta? Atualize a pergunta para que ela se concentre apenas em um problema editando esta postagem . Fechado há 4 anos . De maneira...
Nossa empresa está convertendo muitos processos manuais de negócios (e o conhecimento institucional associado) em novos softwares corporativos. O projeto está indo muito bem, mas, à medida que prosseguimos, fica claro que há muita confusão com relação a termos e definições, tanto no lado comercial...
Fechado . Esta questão é baseada em opiniões . No momento, não está aceitando respostas. Deseja melhorar esta pergunta? Atualize a pergunta para que ela possa ser respondida com fatos e citações editando esta postagem . Fechado há 4 anos . Atualmente,...
Recentemente, deparei com a utilidade de objetos imutáveis e que, por exemplo, se você passa elementos para um construtor e sua classe deve ser imutável, você deve copiar esses elementos se eles não forem imutáveis. Isso requer muita verificação ou conhecimento sobre o meu projeto, porque se eu...
Estamos integrando um processo de teste em nosso processo SCRUM. Minha nova função é escrever testes de aceitação de nossos aplicativos da web para automatizá-los posteriormente. Eu li muito sobre como os casos de teste devem ser escritos, mas nenhum me deu conselhos práticos para escrever casos de...
Atualmente, estou no processo de atualizar um documento de design para que esteja correto e atualizado para futuros desenvolvedores. Atualmente, o documento concentra-se apenas nos fatos, apresentando como é o design. Não há justificativa para nenhuma decisão apresentada. Acredito que é importante...
Para elaborar, estou interessado em saber o que as pessoas pensam que você precisa implementar enquanto ainda é um projeto individual (controle da fonte da equipe, documentação, compilação etc.) e o que as coisas não precisam ser feitas até que a segunda pessoa chegue. para o projeto. Qualquer...