Merge pull request #58 from TeenBiscuits/dev

Dev

CMakeLists.txt

@@ -17,5 +17,5 @@ add_subdirectory(./src/Boletin_4)
 add_subdirectory(./src/Ejemplos)
 # Extras
 add_subdirectory(./src/Extras)
-# Examenes
+# Exámenes
 add_subdirectory(./src/Examenes)

CONTRIBUTING.md

@@ -2,48 +2,66 @@
 
 ### Gracias por querer colaborar
 
-Primero de todo gracias por querer colaborar con Pro2324, gracias a gente como tú proyectos como este són posibles. 😄🥰
+Primero de todo gracias por querer colaborar con **Pro2324**, gracias a gente como tú proyectos como este són posibles.
+😄🥰
 
 ### Qué contribuciones se aceptan
 
-Aceptamos soluciones a ejercicios de los boletines, modificaciones de los ya existentes o nuevos ejercicios. También
-evidentemente parches a cualquier error que se escape por el repositorio.
+Aceptamos soluciones a **ejercicios** de los boletines, modificaciones de los ya existentes o nuevos ejercicios. También
+evidentemente **parches a cualquier error** que se escape por el repositorio.
 
-Se aceptan contribuciones de exámenes de prácticas (o similar) con un candidato a solución. Si resultaran de interés,
-también se añadirán ejemplos y/o extras que puedan resultar educativos/interesantes.
+Se aceptan contribuciones de **exámenes de prácticas** (o similar) con un candidato a solución. Si resultaran de
+interés, también se añadirán **ejemplos** y/o **extras** que puedan resultar educativos/interesantes.
 
-Se aceptan explicaciones y/o resúmenes para los apartados de teoría. También tutoriales que sean interesantes y
-relacionados con la programación en C y/o relacionado.
+Se aceptan **explicaciones**, **apuntes** y/o **resúmenes** para los apartados de teoría. También **tutoriales** que
+sean interesantes y estén relacionados con la programación en C y/o similar.
 
 ### Qué contribuciones no se aceptarán
 
-No se añadirá, ningún proyecto de entrega obligatoria. Los proyectos deben ser realizados por el/la alumno/a en
-cuestión.
+No se añadirá, ningún **proyecto de entrega obligatoria**.
 
 Tampoco se añadirá código que no sea de creación propia o que fuera conseguido de forma ilícita.
 
+Ni se añadirán exámenes, pruebas o demás material **cuyo autor/a no expresase el consentimiento pertinente**.
+
 ### ¿Como contribuir?
 
+> Cita siempre al autor original o a los coautores de todo lo que añadas, **hoy por ti mañana por mi**.
+
 #### Código
 
 **Todo el código está en la carpeta** ``./src`` **y una copia solo de los archivos** ``*.c`` **en el directorio de la
-documentación** ``./docs/code`` Esto es temporal pero es lo mejor que se puede hacer ahora para que la documentación
+documentación** ``./docs/code`` Esto es temporal, pero es lo mejor que se puede hacer ahora para que la documentación
 funcione.
 
 Para este proyecto se utiliza la revisión de lenguaje C, **C99** (ISO/IEC 9899:1999). El proyecto ha sido estructurado
 como un proyecto para el IDE **CLion** by JetBrains (R).
 
 Cada boletín de la asignatura se encuentra en una sub carpeta diferente (Boletin_1, Boletin_2, Boletin_3...). Por otra
-parte, son una excepción a esta regla la carpeta *Prácticas* y *Extras*, donde se añadirá el código hecho en prácticas y
+parte, son una excepción a esta regla la carpeta *Ejemplos* y *Extras*, donde se añadirá el código hecho en prácticas y
 el código que se considere de interés respectivamente.
 
 Cada archivo ```*.c``` es un ejecutable diferente declarado en ``./src/*/CMakeLists.txt`` que a su vez es referenciado
 en el ``./CMakeLists.txt`` del directorio raíz. (Están todos declarados, los que todavía no fueron añadidos con
 un ``#``) Además de añadir sú código también a la carpeta ``./docs/code`` para que pueda ser referenciado más tarde en
 la documentación.
 
-Por norma general en cada boletín solo se empleará lo aprendido en teoría hasta ese bloque, así los ejercicios valdrán
-para quién todavía esté empezando.
+Por norma general en cada boletín **solo se empleará lo aprendido en teoría hasta ese bloque**, así los ejercicios
+valdrán
+para quién todavía esté empezando. En lo referente a los ejercicios en sí se acepta cualquier programa que siga los
+principios del **Teorema de Böhm y Jacopini (o de la programación estructurada)**.
+
+Cabe destacar que es recomendable **añadir comentarios** para dejar por escrito que hacía el programa. En cuanto a la
+cabecera (las primeras líneas del archivo) CLion añade una pequeña nota por defecto, que resulta útil para dar crédito a
+los/as autores/as de los archivos:
+
+```C
+//
+// Created by <nombre> on dd/mm/yyyy.
+//
+```
+
+_Si no es añadida por defecto, añádela, así aquellos que ven los archivos en la web sabrán quien creo el archivo._
 
 A la hora de compilar los ejecutables puede utilizarse cualquier compilador, pero es recomendable, en Windows,
 utilizar [Cywing](https://www.cygwin.com) (Para el correcto de display de tíldes y otros caracteres especiales).

docs/cfg/buildprofiles.xml

@@ -26,7 +26,8 @@
         <link href="https://github.com/TeenBiscuits/Pro2324">GitHub (Danos una ⭐)</link>
         <link href="https://creativecommons.org/licenses/by-nc/4.0/">Licencia Documentación</link>
         <link href="https://www.gnu.org/licenses/gpl-3.0.en.html#license-text">Licencia Código</link>
-        <link href="https://github.com/TeenBiscuits/Pro2324/issues/new/choose">Reportar un Error/Sugerencia</link>
+        <link href="https://github.com/TeenBiscuits/Pro2324/issues/new/choose">Reportar un Error / Sugerencia</link>
+        <link href="https://github.com/sponsors/TeenBiscuits">Apoye el desarrollo</link>
         <link href="https://teenbiscuits.github.io/Pro2324/agradecimientos.html">Agradecimientos</link>
         <copyright>2024 Pablo Portas López</copyright>
     </footer>

docs/pro.tree

@@ -39,8 +39,9 @@
         <toc-element topic="Compilador.md"/>
     </toc-element>
     <toc-element topic="Extras.md"/>
-    <toc-element toc-title="GitHub"
-                 href="https://github.com/TeenBiscuits/Pro2324"/>
-    <toc-element topic="Agradecimientos.md" hidden="true"/>
+    <toc-element toc-title="Reportar un Error/Sugerencia" href="https://github.com/TeenBiscuits/Pro2324/issues/new/choose"/>
+    <toc-element toc-title="GitHub" href="https://github.com/TeenBiscuits/Pro2324"/>
+    <toc-element toc-title="Apoye el desarrollo" href="https://github.com/sponsors/TeenBiscuits"/>
+    <toc-element topic="Agradecimientos.md"/>
     <toc-element topic="Para-Colaboradores.md" hidden="true"/>
 </instance-profile>

docs/topics/Para-Colaboradores.md

@@ -11,8 +11,42 @@ Supongo que ya lo has hecho, pero recuerda leer [la guía de contribución](http
 
 </warning>
 
+<procedure>
+<title>TO DO</title>
+
+Prioridad uno: ¡En Construcción! Segunda prioridad: Próximamente...
+
+- [ ] Introducción Pro (¡En Construcción!)
+- [ ] Bibliografía Pro (¡En Construcción!)
+- [ ] Antiguos exámenes (¡En Construcción!)
+- [ ] Extras (¡En Construcción!)
+- [ ] Ejemplos (Próximamente...)
+- [ ] Añadir tutoriales (Próximamente...)
+- [ ] Boletines Pro II (Próximamente...)
+- [ ] Añadir teoría Pro II (Próximamente...)
+
+</procedure>
+
 <tip>
 <b>En construcción...</b> 
 <!-- No voy a mentir, esto es lo último que tengo 
             como prioridad por acabar          -->
-</tip>
+</tip>
+
+<!-- Ejemplo de Ejecución -->
+
+<procedure>
+<title>Ejemplo de Ejecución</title>
+<p>
+<b>Primer Número:</b> 34<br/>
+<b>Segundo Número:</b> 56<br/>
+<b>Tercer Número:</b> 21<br/>
+</p>
+<p>56 es el número mayor de los tres introducidos</p>
+</procedure>
+
+<!-- Code - Block de Soluciones -->
+
+<code-block src="./Boletin_1/Ejercicio_01.c" lang="C" collapsible="true" collapsed-title="Mostrar Solución"/>
+
+<!--  -->