libreim / overflow

libreimOverflow is based on question2answer
http://tux.ugr.es/dgiimoverflow/
Other
1 stars 1 forks source link

Redactar un FAQ #1

Closed mroman42 closed 8 years ago

mroman42 commented 8 years ago

Voy a ponerme a redactar un FAQ para el foro, que explique su uso y su motivación. Podemos escribir en esta issue las preguntas y respuestas que debería tener.

(@pbaeyens: Añado una lista de posibles preguntas a redactar)

mroman42 commented 8 years ago

¿Cómo puedo registrarme? El registro y el login en el foro se hacen a través de una cuenta en GitHub. Si no tienes una, puedes crearla en github.com. GitHub es una plataforma de desarrollo de software colaborativa, basada en el sistema de control de versiones git. Una vez tengas la cuenta, el foro te pedirá que cedas permisos sobre ella para leer información pública y podrás entrar en tu cuenta.

mroman42 commented 8 years ago

¿Puedo responderme a mí mismo? Sí, y además puedes aceptar tu propia respuesta si consideras que era la más apropiada a la pregunta original. De hecho, es un mecanismo útil si quieres subir una relación de ejercicios resuelta en forma de preguntas y respuestas para discutirla o buscar soluciones alternativas.

mroman42 commented 8 years ago

¿Sobre qué puedo preguntar? Cualquier problema o duda relacionada con las matemáticas o la ingeniería informática. Además, cualquier duda relacionada con este mismo foro. Evita aquellas preguntas en las que:

Puedes usar el foro para discutir algunas de estas cuestiones.

oxcar103 commented 8 years ago

Creo que en la pregunta "¿Sobre qué puedo preguntar?" deberíamos aclarar lo de que no se pongan preguntas de "hazme los deberes" (Con mejor labia que lo que he puesto :sweat_smile:)

mroman42 commented 8 years ago

¿Es sólo para alumnos del doble grado? ¡No! Aunque el blog y el foro los empezamos entre alumnos del doble grado de la Universidad de Granada y la temática está orientada a sus materias, queremos que sean útiles a cuanta más gente mejor. Queremos llegar a todo aquél que le pueda ser útil y animamos especialmente a quien no estudie en el doble grado a participar.

mroman42 commented 8 years ago

@oxcar103 Intentad redactarla alguno, por favor. Yo llevo un rato sin que me salga.

mroman42 commented 8 years ago

¿Cuándo debo usar comentarios y cuando respuestas? Generalmente, una respuesta debe proponer una contestación más o menos completa a la pregunta y no debe usarse para debatir sobre otras respuestas. Los comentarios sirven para dar un debate breve sobre aspectos concretos de las preguntas y las respuestas. Otro posible uso de los comentarios es permitir a quien preguntaba que confirme que la respuesta funciona.

mroman42 commented 8 years ago

¿Cómo puedo escribir matemáticas? Las matemáticas pueden incluirse de dos maneras, una escribiendo en la misma línea con \\( ... \\), y otra escribiéndolas como una ecuación separada con $$ ... $$. Entre estos marcadores debe escribirse usando sintaxis de MathJax, que es similar a la de LaTeX y se explica detalladamente aquí.

mx-psi commented 8 years ago

No sé cómo es la sintaxis así que por favor que alguien añada el resto: ¿Cómo puedo escribir código? El foro procesará como bloques de código los párrafos indentados por 4 espacios. El coloreado de código se realiza usando highlight.js, que detecta automáticamente el lenguaje.

Escribe siempre el ejemplo más conciso que reproduzca tú error. Asegúrate de que tú código sólo tiene el error que quieres resolver y de que puede ejecutarse sin necesidad de añadir código adicional.

mroman42 commented 8 years ago

El foro procesará como bloques de código los párrafos indentados por 4 espacios. El coloreado de código se realiza usando highlight.js, que detecta automáticamente el lenguaje.

mroman42 commented 8 years ago

¿Qué es la categoría Meta? Es la categoría que engloba todas aquellas preguntas relacionadas con el foro en sí. Cómo escribir, cómo responder o cómo participar. Todas las preguntas de este FAQ son buenos ejemplos del tipo de preguntas que se pueden responder allí.

mroman42 commented 8 years ago

¿Qué significa que una respuesta ha sido aceptada? Significa que esa respuesta sirvió a aquél que preguntó. No siempre es un indicador de que sea una respuesta perfecta o la mejor, ni debe tomarse como un cierre definitivo de la pregunta.

mroman42 commented 8 years ago

En la de cómo preguntar/responder, casi copiaría literalmente a SO: http://stackoverflow.com/help/behavior. Enlazarlo no me parece mala idea.

mx-psi commented 8 years ago

¿Qué son las medallas? Recibes medallas cuando realizas aportaciones importantes a dgiimOverflow. Puedes encontrar una lista de medallas aquí (Falta añadir enlace cuando instalemos el plugin). Puedes ver las medallas que un usuario ha conseguido en su perfil.

mx-psi commented 8 years ago

¿Cómo debo preguntar/responder?

Adaptado de StackOverflow