Traducciones:
Inglés
Japonés
Italiano
Ruso
Chino Simplificado

¿Cómo puedo contribuir a esta FAQ de usuarios?

Estamos encantados de recibir cualquier tipo de contribución. Estas contribuciones serán de mucha utilidad la próxima vez que tú u otra persona se hagan la pregunta, "¿cómo podría yo...?".

Para poder añadir un nuevo FAQ o editar alguno de los existentes es necesario que primero dispongas de una cuenta. Si todavía no la tienes, puedes pinchar en el enlace Log In que se encuentra en la parte superior de la página.

Si tienes alguna pregunta o sugerencia sobre este FAQ, por favor, contacta con [docs@glassfish.java.net]. También te puedes suscribir al alias GlassFish de la lista de correo

Diferentes maneras de contribuir

• • Escribe la respuesta a una de las preguntas sin contestar* (las preguntas se encuentran listadas en la sección User FAQ Wish List de la página principal de las FAQs). Quizás te hayas enfrentado al mismo problema y hayas encontrado una solución. Puede que hayas publicado en algún blog algo acerca de esos temas o respondido esa pregunta que aparece una y otra vez repetida en los foros. Cualquier experiencia que puedas compartir será bienvenida.

• • Escribe una pregunta a la que tengas respuesta.* Primero asegúrate que la pregunta no existe ya (si existe, lee el punto anterior). Después, pregúntate a ti mismo si realmente esa pregunta es una pregunta frecuente. ¿Es algo que se ha preguntado y contestado muchas veces en distintas listas de correo? ¿se trata de algo que mucha gente (especialmente nuevos usuarios) probablemente pregunten y para lo que puedan necesitar ayuda?. Si la respuesta es sí, añádela.

• • Añade más información a una FAQ escrita por otra persona.* Si tienes algo que añadir que pueda mejorar una FAQ existente, por favor, no dudes en hacerlo. Puede ser un ejemplo detallado (¡los ejemplos son buenos!), esa solución alternativa que funcionó de madrugada cuando nada más funcionaba, o un buen consejo que la gente deba conocer.

Formato de la FAQ

Todas las entradas de la FAQ deben usar la misma convención de nombres y seguir el mismo formato. Esto es muy importante. Por favor, haz lo siguiente:

• • Usa el prefijo Faq para los nombres de las páginas*, y haz que el resto del nombre sea corto pero descriptivo. Por ejemplo, el nombre de esta página es FaqContributeToUserFAQEs.

• • Añade nuevas FAQs a la categorías adecuadas.* Si no existe la categoría en la página principal GlassFish User FAQ, añádela. También debes añadir la entrada correspondiente en el Índice de Contenidos de la página principal para que la gente puede encontrar rápidamente la entrada que has añadido. Utiliza el mismo formato que tienen el resto de entradas de la página principal.

• • Repite la pregunta en el encabezado de la página de respuesta y asegúrate de que la pregunta cuadra con lo que aparece en la página principal de las FAQs de usuario.*_ Por ejemplo, la pregunta ¿Cómo puedo contribuir a esta FAQ? aparece tanto en la página principal GlassFish User FAQ como en la zona superior de está página de respuesta. Un ejemplo de entrada errónea que debería ser corregida es la pregunta ¿Cómo puedo contribuir a este FAQ? y la respuesta Para contribuir a este FAQ.

• • Si es posible, y si tiene sentido, incluye un número de versión en el encabezado.* Esto ayudará a la gente a saber a que versión de Glassfish va dirigida esa FAQ (v2, v3, Prelude, etc).

• • Usa un encabezado de tamaño medio para la pregunta al principio de tu respuesta*_ (símbolo !!). Por ejemplo, en la parte superior de esta página aparece ¿Cómo puedo contribuir a esta FAQ? con un tamaño de texto ligeramente mayor y un color diferente. Esto se consigue usando el símbolo !! para encabezados.

• • Sigue unas cuantas guías de edición muy simples.* El nombre GlassFish tiene una F mayúscula. Se debe escribir GlassFish en vez de Glassfish. El número de versión irá acompañado de una v minúscula. Por ejemplo, v2 o v3 en vez de V2 o V3. Se debe usar una v minúscula en vez de la palabra completa versión. Por ejemplo, se debe usar v3 en vez de versión 3. Aunque esta norma no se sigue en toda la wiki debe seguirse para añadir nuevo contenido. Puedes encontrar más guías de edición en GlassFish v3 Documentation Style Sheet.

Guía para contenidos de la FAQ

• • Sigue la guías de formato listadas más arriba.* La consistencia es importante.

• • Asegúrate de que la FAQ está orientada al usuario más que estar orientada al desarrollador*, oriéntala más hacía el usuario de GlassFish que hacía el desarrollador de GlassFish. Para preguntas orientadas al desarrollador, visita la página GlassFish Developer FAQ.

• • Haz que el título de tu FAQ sea una pregunta real que alguien realmente pudiera preguntar.* Debe ser corta y concreta, idealmente no debe ser más larga de una linea y debe suponer un resumen conciso del tema que se va a tratar.

Para añadir nuevas FAQs

1. Pulsa Log In en la parte superior de la página y autentícate. Es necesario que abras una cuenta si no tienes una. Si necesitas más información sobre el registro visita la página ¿Cómo me registro?.
2. Pulsa GlassFish User FAQ a la izquierda de esta página si todavía no estás allí. Se mostrará la página GlassFishUserFAQ.
3. Pulsa Edit en la parte inferior de la página. La opción Edit no está disponible si no te has logado. Visite ¿Por qué no puedo editar una página en la wiki de GlassFish? si estás logado y la opción Edit no está disponible.
4. Desplázate hasta la categoría apropiada (por ejemplo Instalación) y añade tu pregunta a la lista, siguiendo el formato usado para el resto de preguntas y ten en cuenta las guías listadas más arriba. Si no encuentra una categoría apropiada, cree una. Importante: Si añade una categoría nueva debes añadir también una entrada en el cuadro de contenidos. Sigue el mismo formato usado para otras entradas.
5. Previsualiza tu entrada, modifícala si es necesario y salva.
6. Pincha en tu pregunta en la lista de la página GlassFishUserFAQ y añade contenido a la página de respuesta.
7. Previsualiza tu contenido, modifícalo si es necesario y salva.

Para editar FAQs existentes

1. Pulsa Log In en la parte superior de la página y autentícate. Es necesario que abras una cuenta si no tienes una. Si necesitas más información sobre el registro visita la página ¿Cómo me registro?.
2. Pulsa GlassFish User FAQ a la izquierda de esta página si todavía no estás allí. Se mostrará la página GlassFishUserFAQ.
3. Pulsa el enlace correspondiente al FAQ que quieras editar. Aparecerá la página de respuesta.
4. Pulsa Edit en la parte inferior de la página. La opción Edit no está disponible si no te has logado. Visite ¿Por qué no puedo editar una página en la wiki de GlassFish? si estás logado y la opción Edit no está disponible.
5. Edita el contenido de la página
6. Previsualiza los cambios, modifícalos si es necesario y salva.