CUDI-CDR Abril-2002 RFCMX 1 M. Farias-Elinos (ULSA) Categoria: Informativo C. A. Altamirano (UNAM) Grupo de Seguridad J. G. Hernandez (UANL) G. Wolf (UNAM) M. A. Balderas (UAT) Convenciones para la documentacion Resumen: En este documento se definen las convenciones para el desarrollo de la documentacion tecnica, organizacional y administrativa que sean generados por los miembros de la Corporacion Universitaria para el Desarrollo de Internet (CUDI) y que formaran parte de la serie RFCMX dentro de la red de Internet-2 Mexico. Palabras claves: Internet-2 Mexico, CUDI, Solicitud de Comentarios, Convenciones. Derechos de Copia Copyright (C) CUDI-CDR-Grupo de Seguridad (2002). Todos los derechos Reservados. La distribucion de este memo no esta limitada. Tabla de contenido 1. Introduccion . . . . . . . . . . . . . . . . . . . . . . . . 1 2. Formato . . . . . . . . . . . . . . . . . . . . . . . . . . 2 3. Contenido . . . . . . . . . . . . . . . . . . . . . . . . . 4 4. Evaluacion . . . . . . . . . . . . . . . . . . . . . . . . . 5 5. Publicacion . . . . . . . . . . . . . . . . . . . . . . . . 5 6. Datos autores . . . . . . . . . . . . . . . . . . . . . . . 6 1. Introduccion El comite de Desarrollo de la Red (CDR) tiene como objetivo primordial el establecer los lineamientos tecnicos (hardware y software) que coadyuven al desarrollo de la Internet-2 en Mexico, por lo cual se ve en la necesidad de establecer la serie de Solicitud de Comentarios (Request for Comments) para Mexico (RFCMX) como una documentacion tecnica y organizacional que definen las especificaciones utilizadas por la red de CUDI tanto en su parte de redes y telecomunicaciones como en las aplicaciones. M. Farias-Elinos et al Pagina 2 RFCMX 1 Convenciones para la documentacion ABRIL-2002 La documentacion que se incluya en esta serie puede ser producida por cualquier persona, o grupo de personas, siempre y cuando sean parte de alguna institucion que sea miembro activo de CUDI, y sea evaluado por el Comite respectivo. Cabe mencionar que actualmente existen tres comites dentro de CUDI, el CDR, el Comite de Aplicaciones y Asignacion de Fondos (CAAF), y el Comite de Membresias (CM). 2. Formato El reporte debera estar a una columna con tipografia "times new roman" de 12 puntos, con excepcion del titulo principal que sera de 16 puntos en negritas; y los titulos de seccion que seran de 14 puntos, en italica, negrillas y con numeracion consecutiva. En la parte superior izquierda de la primera hoja se tendra: CUDI-sss RFCMX x Categoria: y Obsoleta: z Grupo de trabajo donde: sss especifica el comite en el cual se genera dicho documento, pudiendo ser: CDR (Comite de Desarrollo de la Red), CAAF (Comite de Aplicaciones y Asignacion de Fondos) y CM (Comite de Membresias), pudiendo crearse mas comites. x Es un numero consecutivo, el cual estara a cargo del coordinador del grupo de seguridad y Especifica la categoria en la que entra dicho documento, siendo: * Informativo * Estandar * Experimentales * Especificativo z Indica el numero de documento anterior al cual esta inutilizando por la actualizacion que representa el documento generado. trabajo Es el nombre del grupo que propone del documento, cabe mencionar que cada Comite esta conformado por grupos de trabajo. CUDI-CDR-Grupo de Seguridad INFORMATIVO M. Farias-Elinos et al Pagina 3 RFCMX 1 Convenciones para la documentacion ABRIL-2002 En la parte superior derecha de la primera hoja se tendra: Fecha del documento en el formato mes-ao Nombre del o los autores con las siglas de la institucion a la que pertenecen En la parte superior de la primera hoja, debera de ir el titulo del documento,seguido de un resumen no mayor a 300 palabras, posteriormente debera venir la frase palabras clave seguido de los terminos claves que se involucran en el RFCMX, no siendo mayor a seis terminos. Enseguida la leyenda: Derecho de Copia, Copyright CUDI-sss-grupo de trabajo (ao). Todos los Derechos Reservados La distribucion de este memo no esta limitada. Posteriormente un indice a un nivel, donde el nombre de cada seccion refleje el contenido de dicha seccion facilitando la busqueda de la informacion. En el extremo superior izquierdo de las siguientes hojas se tendra: El nombre del primer autor, si son varios, el nombre del primer autor seguido por las palabras "et al" La palabra RFCMX seguido del numero asignado En el extremo superior derecho de las siguientes hojas se tendra: El numero de pagina Fecha en el formato mes-ao En la parte superior y centrado de las siguientes hojas se tendra: El titulo del documento En la parte inferior izquierda de las siguientes hojas se tendra: La palabra CUDI seguido de las siglas del comite y del grupo de trabajo que propone el documento. En la parte inferior derecha de las siguientes hojas se tendra: La categoria en la que entra dicho documento. En la ultima parte, antes de las referencias, debera incluirse^M los datos de contacto de los autores, tales como direccion fisica, Institucion, telefonos, fax, correo electronico. A dos columnas. CUDI-CDR-Grupo de Seguridad INFORMATIVO M. Farias-Elinos et al Pagina 4 RFCMX 1 Convenciones para la documentacion ABRIL-2002 3. Contenido Los objetivos de esta serie son: * Generar una documentacion escrita y valida donde se discutan los diversos aspectos de redes, protocolos, procedimientos, aplicaciones, opiniones y especificaciones enfocados al desarrollo de la Internet-2 en Mexico. * Ofrecer una base de informacion del dominio publico de consulta para cualquier persona en la red donde se pueda observar la evolucion que se ha tenido en el desarrollo de la Internet-2 en Mexico. * Generar una documentacion tecnica donde se pueda establecer los medios, formas y configuraciones validas para los diversos equipos utilizados en la red Internet 2 en Mexico. * Generar una documentacion con fines de evaluacion y experimentacion que permitan la evolucion y dar soporte a las necesidades futuras de red, aplicaciones o servicios en la red Internet 2 en Mexico. El contenido de la documentacion puede ser de tipo: a. Especificaciones b. Implementaciones tecnicas c. Estandares d. Propuestas e. Memoria tecnica En el caso de las implementaciones tecnicas, se debera contener una breve explicacion de las bases, haciendo referencia a los documentos (libros, articulos en revistas, etc) donde se pueda profundizar mas sobre los aspectos teoricos, asi mismo contendra la explicacion a las configuraciones utilizadas y los resultados de las pruebas realizadas. Para el caso de las especificaciones, estandares y propuestas deberan contener las bases formales indicando, a traves de las referencias, los documento o estandares de donde se estan basando para el desarrollo del documento. En el resumen debera contener la importancia, relevancia y aportacion del escrito de una manera general, asi mismo, el indice estara desglosado a un nivel reflejando las secciones en las que se divide del documento, las palabras claves deberan reflejar la tematica del documento. CUDI-CDR-Grupo de Seguridad INFORMATIVO M. Farias-Elinos et al Pagina 5 RFCMX 1 Convenciones para la documentacion ABRIL-2002 Cabe mencionar que los RFCMX no estan limitados a cuestiones tecnicas de la red, sino tambien involucra el desarrollo de aplicaciones realizadas por las universidades y centros de investigacion que aprovechen las bondades y capacidades de la redCUDI. 4. Evaluacion Para la publicacion del documento es necesario que los autores, miembros de CUDI, hagan llegar al CDR el documento para ser evaluado, para ello el CDR se conforma por: * Presidente, electo anualmente[1] * Secretario, electo anualmente * 6 Vocales, electos anualmente * Coordinadores de grupos de trabajo o Enrutamiento o Seguridad o NOC o Extremo a Extremo o Topologia o Calidad de servicio o MPLS o Multicast o IPv6 o H.323 Para el caso donde los documentos cuyo contenido no tenga que ver con las cuestiones tecnicas de la red, dicho documento sera enviado al comite respectivo, o en el caso de que el documento tenga que ver con varios comites, se formara un grupo de revisores afines al tema. Los revisores daran si veredicto al CDR quien notificara del resultado, asi como de los comentarios que se realicen al documento. 5. Publicacion El documento, una vez aprobado, se agregara a los demas documentos generados, publicandose en la direccion http://rfc.cudi.edu.mx/, pudiendo haber otros sitios espejo o alternos, quedando el sitio principal bajo la responsabilidad del grupo de seguridad. Cada RFCMX multiplo de 100 se utilizara para tener un pequeo compendio de los RFCMX anteriores que contendra el numero del RFCMX, el primer autor, el titulo, la fecha y el resumen. CUDI-CDR-Grupo de Seguridad INFORMATIVO M. Farias-Elinos et al Pagina 6 RFCMX 1 Convenciones para la documentacion ABRIL-2002 Para la publicacion[2] del documento se utilizaran los formatos ASCII, PDF, PS y HTML, siguiendo la siguiente nomenclatura para los nombres de los archivos: * rfcmx####.txt para el formato ASCII * rfcmx####.pdf para el formato PDF * rfcmx####.ps para el formato PostScript * rfcmx####.html para el formato HTML En el caso de los archivos PDF y HTML deberan contener, en los campos especificos de cada formato, las palabras claves y descripcion breve del documento, con la intencion de facilitar su busqueda. 6. Datos autores Mario Farias-Elinos Universidad La Salle (ULSA) Escuela de Ingenieria/Direccion de Posgrado e Investigacion Benjamin Franklin 47 Col. Hipodromo Condesa Mexico, DF, 06140 Tel: (55) 5278-9539 Fax: (55) 5515-7631 e-mail: elinos@ci.ulsa.mx Carlos A. Vicente Altamirano Universidad Nacional Autonoma de Mexico (UNAM) Direccion General de Servicios de Computo Academico (DGSCA) Centro de Operacion de la Red Circuito Exterior S/N, C.U. Mexico, DF, 04510 Tel: (55) 5622-8526 e-mail: carlos@antares.noc.unam.mx Jose Guadalupe Hernandez E. Universidad Autonoma de Nuevo Leon (UANL) Direccion de Sistemas e Informatica Tel: (81) 8329-4040 x 4102 e-mail: josherna@dsi.uanl.mx CUDI-CDR-Grupo de Seguridad INFORMATIVO M. Farias-Elinos et al Pagina 7 RFCMX 1 Convenciones para la documentacion ABRIL-2002 Gunnar Wolf Universidad Nacional Autonoma de Mexico (UNAM) FES Iztacala Av. de los Barrios #1 Col. Los Reyes Iztacala Tlalnepantla, Edo. de Mexico, 59040 Tel: (55) 5623-1118 Fax: (55) 5623-1119 e-mail: gwolf@campus.iztacala.unam.mx Marco A. Balderas Universidad Autonoma de Tamaulipas (UAT) UAMAC / CEPRODAVI e-mail: wokn@mail.ru Referencias [1] Reglamento de CUDI. [2] Postel, J., Reynolds, J., Instructions to RFC Authors, RFC 2223, October 1997 CUDI-CDR-Grupo de Seguridad INFORMATIVO