Crear contenido wiki

Un artículo wiki consiste en el desarrollo de contenido que conformará y enriquecerá la base de conocimiento de las asignaturas de Gestión de Redes. Este artículo, según la definición de contenido de este portal, podrá tratar sobre la elaboración (creación o edición) tanto de preguntas frecuentes, guías prácticas, resolución de problemas comunes o, incluso, contenido teórico expandido sobre las referidas materias.

Formato del contenido

Toda aportación debe seguir íntegramente las características del contenido expresadas en el apartado respectivo.

Propósito de este artículo

Este artículo presentará las reglas básicas que deberá considerar toda colaboración que se publique en esta base de conocimiento, en cuanto a características de estilo y aspectos utilizados por el motor wiki; tal como se comentó en el apartado anterior, los aspectos de contenido son discutidos en otro artículo.

Contenido o colaboraciones a las que aplica

Las indicaciones acá presentadas aplican para los aportes de tipo guía práctica, resolución de problemas y documentación de conceptos teóricos.

Por su naturaleza, las presentes consideraciones NO aplican a la hora de contribuir con el desarrollo de preguntas frecuentes.

Como colaborar en este portal

La participación en esta base wiki es opcional, los estudiantes de las asignaturas de Gestión de Redes tienen libertad para decidir si participan o no en esta dinámica.  En caso una persona desee colaborar, debe solicitar personalmente su inscripción a este portal a fin de que el personal administrador – docente le asigne una cuenta de usuario para poder iniciar con sus aportes.

La solicitud debe ser enviada exclusivamente desde el portal de Academia y notificada por medio verbal y/o herramientas de mensajería instantánea. Una vez recibida la solicitud, podría tomar hasta 7 días calendario en entregarse la nueva cuenta de usuario.

Estructura de los artículos o colaboraciones

A efectos de estandarizar el desarrollo de sus participaciones y aportes, a todo participante se le requerirá la siguiente estructura al trabajar con el motor wiki de este portal, procurando de esta manera el contar con un valioso acerco de conocimiento que mantenga una vista uniforme a pesar de la multiplicidad de editores.

Un artículo creado en este portal wiki debe comprender las siguientes secciones:

1. Resumen introductorio.
2. Sumario.
3. Desarrollo del material (apartados y subapartados).
4. Sección véase también, cuya obligatoriedad estará a sujeta al tipo de aporte presentado.
5. Referencias (opcional).
6. Fuentes utilizadas.
7. Enlaces externos (obligatoriedad de acuerdo con el tipo de aporte).
8. Categoría a la cual pertenece el artículo.

Resumen introductorio

Como su nombre lo indica, el artículo debe iniciar presentando un breve resumen que sirva como preámbulo de todo el contenido a presentar. Debería incluir únicamente aspectos básicos pero relevantes (tal como concepto general, consideraciones de autor, fechas de desarrollo, implicaciones a causa del tema, etc.). Es en este apartado donde el autor dejará claro el tipo de contenido a presentar (teoría, resolución de preguntas frecuentes, manual, resolución de problema, etc.) a efectos de que los lectores comprendan sobre que tratará el resto del artículo.

Para esta sección, bastará con plantear uno o dos párrafos en tanto se logre el objetivo de tener una introducción completa e integral del tema a discutir.

Sumario

El sumario o índice se genera automáticamente, en tanto el artículo cuente con al menos 3 secciones ampliamente detalladas, haciendo uso del formato wiki de títulos o niveles.

Desarrollo del material

Esta sección corresponde al contenido real del artículo, de acuerdo con la colaboración realizada y los elementos que se solicita cumplir en cada tipo de aporte. El desarrollo y creación de estos elementos se realiza a través de diversos fragmentos de texto.

Considere que este portal wiki le ofrecerá la posibilidad de hacer uso de dos tipos de herramientas para ingreso de texto: el editor visual, el cual funcionará básicamente como un editor de texto enriquecido; así como el editor de código, que funciona según el estándar de lenguaje de marcado de wiki. Preferentemente, se recomienda hacer uso de esta segunda modalidad para ingreso de texto, aunque se reconoce la comodidad de hacer uso del primer método; aun así, favor considerar que hay algunos bugs o aspectos problemáticos conocidos para el editor visual, por lo que Ud. debería trabajar principalmente en la modalidad visual, pero cerciórese de realizar ajustes y revisiones por medio del editor de código.

Organice el contenido, según corresponda, por medio de títulos -desde nivel 2 hasta nivel 6- para ir presentando los apartados principales (título / nivel 2) y sus correspondientes subtemas (subtítulo 1 / nivel 3 en adelante). El propósito es organizar el contenido apropiadamente a fin de desarrollar la aportación y su contenido por diferentes niveles de complejidad y de detalle.

Favor tome nota de los comentarios presentados entre paréntesis en el párrafo anterior, ya que tanto el editor visual como el editor de código manejan los diferentes grados de detalle, pero con términos un tanto diferentes:

Cabecera de nivel	Término - editor visual	Término - editor código
Principal	Título	== Nivel 2 ==
Secundario	Subtítulo 1	=== Nivel 3 ===
Terciario	Subtítulo 2	=== Nivel 4 ===
...	...	...

De este modo, el desarrollo del material debería iniciar con la presentación de temas principales (Título, según editor visual; texto Nivel 2, según editor de código), continuando con temas secundarios (Subtítulo, según editor visual; texto Nivel 3, según editor de código), etc. Por lo demás, Ud. ya debería tener costumbre de combinar diferentes formatos (párrafos normales, negritas, cursivas, etc.) según sea razonable para la presentación de un contenido.

Precaución con enlaces internos

En la documentación oficial existe amplia descripción sobre la creación de enlaces internos; a efectos de esta base de conocimiento, solo se le solicita y recomienda ser coherente con la creación de enlaces y sus URLs resultantes. En resumen, en cuanto a los enlaces internos, estos están formados por dos elementos:

• Título de página, el cual corresponde al enlace web y URL que se creará dentro del portal wiki.
• Título del enlace, que consiste en el texto descriptivo sobre el cual una persona lectora hará clic.

Por lo anterior, el título de página debe ser lo más genérico posible, enfocado en el tema que se desarrollará en la nueva página siendo creada para la aportación; por el contrario, dado que el título del enlace será el texto o leyenda visible al lector, éste puede ser lo más descriptivo posible.

Se pide encarecidamente que evite crear títulos de página con las siguientes características:

• Excesiva cantidad de texto, el título de página debe consistir únicamente en el enunciado general de la temática a presentar.
• Inclusión de caracteres o signos especiales.
• Texto sin sentido con relación al tema por desarrollar.

Aportaciones que violen estas normas podrán ser desestimadas por el equipo editor – docente e, incluso, retiradas del portal debido a que dañan la estructura de enlaces y rutas URL.

Ejemplos:

Caso - enlace	Enlace - editor visual	Enlace - editor código	Resultado
Texto enlazará al tema básico de DHCP			Apropiado
Texto enlazará al tema básico de Active Directory			Apropiado
Texto enlazará al tema básico de DHCP			Se rechazará como enlace
Texto enlazará al tema básico de Active Directory			Se rechazará como enlace