ceald1/evilwinrm-ngCliente WinRM basado en Go para ejecución remota de comandos y movimiento lateral en sistemas Windows durante pruebas de penetración.
Para facilitarle el inicio con GitLab, aquí tiene una lista de pasos recomendados.
¿Ya eres un profesional? Simplemente edita este README.md y hazlo tuyo. ¿Quieres hacerlo fácil? Usa la plantilla al final.
cd existing_repo
git remote add origin https://gitlab.com/ceald1/evilwinrm-ng.git
git branch -M main
git push -uf origin main
Usa la integración continua integrada en GitLab.
Cuando estés listo para hacer este README tuyo, solo edita este archivo y usa la práctica plantilla 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 cuáles de estas secciones 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, es mejor que sea demasiado largo que demasiado corto. Si crees que tu README es demasiado largo, considera utilizar otra forma de documentación en lugar de recortar información.
Elige un nombre autoexplicativo para tu proyecto.
Haz saber a las personas qué puede hacer específicamente tu proyecto. Proporciona contexto y añade un enlace a cualquier referencia que los visitantes puedan no conocer. También se puede añadir aquí una lista de Características o una subsección de Antecedentes. Si hay alternativas a tu proyecto, este es un buen lugar para enumerar factores diferenciadores.
En algunos READMEs, puedes ver pequeñas imágenes que transmiten metadatos, como si todas las pruebas están pasando para el proyecto. 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 haciendo, puede ser buena idea incluir capturas de pantalla o incluso un video (frecuentemente verás GIFs en lugar de videos reales). Herramientas como ttygif pueden ayudar, pero echa un vistazo a Asciinema para un método más sofisticado.
Dentro de un ecosistema particular, puede haber una forma común de instalar cosas, como usando Yarn, NuGet o Homebrew. Sin embargo, considera la posibilidad de que quien lea tu README sea un novato y quiera más orientación. Enumerar pasos específicos ayuda a eliminar ambigüedades y permite que las personas usen tu proyecto lo más rápido posible. Si solo funciona en un contexto específico, como una versión particular de un lenguaje de programación o sistema operativo, o tiene dependencias que deben instalarse manualmente, añade también una subsección de Requisitos.
Usa ejemplos generosamente y muestra la salida esperada si puedes. Es útil tener en línea el ejemplo más pequeño de uso que puedas demostrar, mientras proporcionas enlaces a ejemplos más sofisticados si son demasiado largos para incluirlos razonablemente en el README.
Dile a las personas dónde pueden buscar ayuda. Puede ser cualquier combinación de un rastreador de issues, una sala de chat, una dirección de correo electrónico, etc.
Si tienes ideas para futuros lanzamientos, es 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 quieren hacer cambios a tu proyecto, es útil tener algo de documentación sobre cómo empezar. Quizás hay un script que deben ejecutar o algunas variables de entorno que necesitan configurar. Haz estos pasos explícitos. Estas instrucciones también podrían ser útiles para tu yo futuro.
También puedes documentar comandos para aplicar lint al código o ejecutar pruebas. Estos pasos ayudan a asegurar una alta calidad del código y reducen la probabilidad de que los cambios rompan algo inadvertidamente. Tener instrucciones para ejecutar pruebas es especialmente útil si requiere configuración externa, como iniciar un servidor Selenium para probar en un navegador.
Muestra tu agradecimiento 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 elegir bifurcar tu proyecto u ofrecerse como mantenedor o propietario, permitiendo que tu proyecto continúe. También puedes hacer una solicitud explícita de mantenedores.