
Escanea proyectos Java mediante pom.xml o build.gradle — coincidencia de CVE para dependencias de Maven/Gradle
Para facilitarte el inicio con GitLab, aquí tienes una lista de próximos pasos recomendados.
¿Ya eres un experto? Solo edita este README.md y hazlo tuyo. ¿Quieres que sea más fácil? Usa la plantilla que aparece al final.
cd existing_repo
git remote add origin https://gitlab.com/valtersit/java-cve-scanner.git
git branch -M main
git push -uf origin main
Utiliza la integración continua integrada en GitLab.
Cuando estés listo para hacer tuyo este README, simplemente edita este archivo y usa la práctica plantilla que aparece a continuación (o siéntete libre de estructurarlo como quieras: ¡esto es solo un punto de partida!). Gracias a makeareadme.com por esta plantilla.
Cada proyecto es diferente, así que considera qué secciones de estas se aplican al tuyo. Las secciones usadas en la plantilla son sugerencias para la mayoría de los proyectos de código abierto. También ten en cuenta que, aunque un README puede ser demasiado largo y detallado, demasiado largo es mejor que demasiado corto. Si crees que tu README es demasiado largo, considera utilizar otra forma de documentación en lugar de eliminar información.
Elige un nombre autoexplicativo para tu proyecto.
Haz que la gente sepa qué puede hacer tu proyecto específicamente. Proporciona contexto y añade un enlace a cualquier referencia con la que los visitantes puedan no estar familiarizados. También se puede añadir aquí una lista de Características o una subsección de Antecedentes. Si existen alternativas a tu proyecto, este es un buen lugar para enumerar los factores diferenciadores.
En algunos README, puedes ver pequeñas imágenes que transmiten metadatos, como si todas las pruebas del proyecto están pasando o no. Puedes usar Shields para añadir algunas a tu README. Muchos servicios también tienen instrucciones para añadir una insignia.
Dependiendo de lo que estés creando, puede ser una buena idea incluir capturas de pantalla o incluso un vídeo (con frecuencia verás GIF en lugar de vídeos reales). Herramientas como ttygif pueden ayudar, pero echa un vistazo a Asciinema para un método más sofisticado.
Dentro de un ecosistema concreto, puede haber una forma común de instalar cosas, como usar Yarn, NuGet o Homebrew. Sin embargo, considera la posibilidad de que quien esté leyendo tu README sea un principiante y desee más orientación. Enumerar pasos específicos ayuda a eliminar la ambigüedad y hace que la gente empiece a usar tu proyecto lo antes posible. Si solo se ejecuta en un contexto específico, como una versión concreta de un lenguaje de programación o un sistema operativo, o tiene dependencias que deben instalarse manualmente, añade también una subsección de Requisitos.
Usa ejemplos con generosidad y muestra el resultado esperado si puedes. Es útil tener en línea el ejemplo de uso más pequeño que puedas demostrar, a la vez que proporcionas enlaces a ejemplos más sofisticados si son demasiado largos para incluirlos razonablemente en el README.
Dile a la gente dónde puede acudir para obtener ayuda. Puede ser cualquier combinación de un rastreador de incidencias, una sala de chat, una dirección de correo electrónico, etc.
Si tienes ideas para futuras versiones, es una buena idea enumerarlas en el README.
Indica si estás abierto a contribuciones y cuáles son tus requisitos para aceptarlas.
Para las personas que quieran hacer cambios en tu proyecto, es útil contar con algo de documentación sobre cómo empezar. Quizás haya un script que deban ejecutar o algunas variables de entorno que necesiten configurar. Haz explícitos estos pasos. Estas instrucciones también podrían ser útiles para tu yo del futuro.
También puedes documentar los comandos para ejecutar el linter sobre el código o ejecutar las pruebas. Estos pasos ayudan a garantizar una alta calidad del código y reducen la probabilidad de que los cambios rompan algo inadvertidamente. Tener instrucciones para ejecutar las pruebas es especialmente útil si requiere una configuración externa, como iniciar un servidor Selenium para probar en un navegador.
Muestra tu aprecio a quienes han contribuido al proyecto.
Para proyectos de código abierto, indica cómo está licenciado.
Si te has quedado sin energía o tiempo para tu proyecto, pon una nota al principio del README diciendo que el desarrollo se ha ralentizado o detenido por completo. Alguien puede optar por hacer un fork de tu proyecto o ofrecerse voluntario para asumir como mantenedor o propietario, permitiendo que tu proyecto siga adelante. También puedes hacer una solicitud explícita de mantenedores.
Descubre las herramientas más usadas por nuestra comunidad.
Sin datos de popularidad aún.