Actualmente estoy trabajando en un proyecto, donde tengo que analizar los requisitos de dos sistemas de TI dados, que usan la computación en la nube, para una API en la nube. En otras palabras, tengo que analizar qué requisitos tienen estos sistemas para una API en la nube, de modo que puedan...
¿Cuál sería una buena alternativa a la documentación en línea de Java, es decir, puede uno tener un archivo de documentos separado de alguna manera asignado a un archivo fuente de Java? Nunca me han gustado las grandes secciones de comentarios llenas de
Actualmente estoy trabajando en una implementación establecida en JavaScript. Esto debería simular genéricos como se conoce de Java o C #. Necesito una versión mutable de eso (permite agregar / eliminar valores establecidos) y una inmutable. Mi firma de constructor se ve así: new GenericSet(...
Estoy tratando de documentar una pieza de software que escribí en detalle. Un SAS tiene un nivel demasiado alto y no cubre la API. Encontré varios ejemplos de una SDS en línea, pero no veo una tendencia en su formato. Me pregunto si hay algunas pautas generales para escribir una especificación de...
Crear una biblioteca C ++ también significa documentarla para que otros puedan usarla, y esa documentación puede variar drásticamente en calidad. ¿Cómo debe estructurarse un sitio web para una biblioteca C ++ para que sea más efectivo? Enmarcaría "más eficaz" como dividido entre tres grupos...
Cerrada . Esta pregunta está basada en la opinión . Actualmente no está aceptando respuestas. ¿Quieres mejorar esta pregunta? Actualice la pregunta para que pueda ser respondida con hechos y citas editando esta publicación . Cerrado hace 6 años .
Tenemos como 20-30 módulos / soluciones independientes. Cada uno de estos tiene entre 7 y 10 proyectos con diferentes clases, componentes, etc. Todos estos se utilizan internamente en nuestra empresa. Nuestro problema es que cuando hacemos un cambio en un módulo, debemos asegurarnos de actualizar...
Creo que uno de los mayores puntos débiles al trabajar con microservicios es asegurarse de que las API estén bien documentadas y que las API no cambien su comportamiento sin afectar las aplicaciones posteriores. Este problema se amplifica cuando tiene muchos servicios que son interdependientes...