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

Véase también

La intención de esta sección es proporcionar al lector la referencia o enlace a otros artículos de interés o que tengan alguna relevancia relativa al tema desarrollado. Por efecto lógico, si Ud. está documentando un tema principal (tal como DHCP, por ejemplo) puede crear la referencia a uno de los múltiples temas secundarios (por ejemplo, Opciones DHCP); de igual manera, si estuviese documentando un tema secundario, perfectamente puede referir hacia el tema principal.

Tal como lo establece la documentación oficial de Wikipedia, es importante procurar que los enlaces referidos en esta sección no apunten a artículos que no existan (la mejor solución a esto es que Ud. cree un enlace nuevo e inmediatamente cree el contenido de dicho artículo nuevo, a fin de mejorar la calidad general de la base wiki).

Referencias

Dado que Ud. estará realizando su propia redacción, el artículo indudablemente contará con notas insertadas (el equivalente de notas al pie en el caso de Word) que hagan constar las fuentes o elementos bibliográficos que respaldan lo documentado en el artículo.

Para más información consulte el uso de etiquetas <ref> y </ref> en la documentación oficial.

Fuentes utilizadas

La más simple de las secciones requeridas, este apartado debe consistir en la denotación de la bibliografía utilizada, de acuerdo con el estándar APA.

Enlaces externos

Esta sección debe ser utilizada para incluir hipervínculos hacia sitios web adicionales que puedan tener relación al artículo. Por ejemplo, retomando el ejemplo de DHCP, sería interesante incluir un enlace hacia las RFCs que documentan dicho protocolo.

Categoría a la cual pertenece el artículo

Al final de todo el artículo, se debe incluir un enlace a la categoría o categorías a las cuales pertenece el artículo. Por ejemplo, si Ud. está documentando las opciones DHCP, debería referir el artículo a las categorías Gestión de redes 1 (como categoría principal), DHCP y Direccionamiento (como categorías de segundo nivel), por ejemplo.

Error conocido con el editor visual

Si bien el editor visual incluye una herramienta para establecer las categorías en que se debe incluir el artículo, se recomienda realizar este paso al final de su proceso de colaboración.  Cuando Ud. edita una página ya existente, que ya tiene asignada(s) la(s) categoría(s) en que se clasifica, al guardar las modificaciones suele perderse la información de este apartado y presentarse dentro de la página en esta manera:

En estos casos, se debe realizar la respectiva corrección desde el editor de código, para dejar la información en la manera adecuada:

Considere: el no ajustar este detalle, cuando suceda el error, repercutirá en incumplimiento de la estructura y contenido mínimo solicitado, lo que podrá incidir en la posible valoración de sus aportes y provocar que su colaboración sea eliminada del portal.

Fuentes utilizadas

Sánchez, C. (2020-08-04). Normas APA 7ma edición. Normas APA. Dirección web.

Enlaces externos

Modelo artículo Wikipedia