Plantilla discusión:Ficha de idioma/doc
Documentación deficiente[editar]
No entiendo lo de documentación deficiente ¿podéis aclarlo? ¿Habéis considerado esto Wikiproyecto:Lenguas del mundo/Cómo leer una ficha de lengua? --Davius (discusión) 21:09 18 oct 2012 (UTC)
Hola Davius. El propósito de "documentación deficiente" es indexar todas las plantillas que a priori no ofrezcan una documentación en su propia página, principalmente para permitir que los usuarios novatos las puedan utilizar con facilidad. Además es necesario estandarizarlas. Ten en cuenta que no todos sabrían encontrar tu wikiproyecto. Saludos cordiales. --Canopus49 
Responder 21:49 18 oct 2012 (UTC)
- Canopus49: creo que es preciso aclarar qué se entiende por "deficiente", pues al parecer tu concepto difiere del que podamos tener otros usuarios. Ciertamente hay ejemplos obvios donde los parámetros no están explicados, sin embargo, en casos como este no veo tan clara la introducción de la plantilla. Por otro lado, se ha trabajado ya sobre estándares de documentación de plantillas, pero el que una documentación no siga este estándar, en mi opinión no debería de ser razón (al menos en una primera etapa) para que poseyera esta plantilla de mantenimiento. Yo me centraría primero en las documentaciones que requieren de una explicitación de los parámetros, un ejemplo y la explicación de los parámetros menos obvios. Farisori » 10:07 19 oct 2012 (UTC)
Hecho De nuevo, perdonen el atisbo de improvisación; ya agregué la posibilidad de explicar, por medio de parámetros, qué problema hay en la documentación. En este caso, está incompleta. --Canopus49 
Responder 16:54 19 oct 2012 (UTC)
- Lo que quiero decir es que no creo que la documentación esté necesariamente incompleta: hay un enlace que acaba por explicarla, y cuyo contenido puede que resulte demasiado extenso como para que sea incluido en la documentación directamente... no digo que así sea: digo que este, como otros, son casos relativos, donde para algunos puede no ser la mejor manera de documentar, pero para otros sí; es preciso encontrar consensos y llegar a un estándar, de acuerdo, pero el que la documentación así como está sea "deficiente", en los términos actuales, creo que es una exageración. Saludos, Farisori » 17:11 19 oct 2012 (UTC)
- Bien, gracias por hacerme notar las falencias de la mía, me ayuda a mejorarla y a darme cuenta de lo que pasé por alto. Ante este caso agregué un segundo parámetro, que permite dar detalles sobre lo que el primer parámetro dice. Volviendo al tema de esta plantilla, como expliqué en la plantilla, valga la redundancia, hay parámetros como "h1", "rank", etc. que no son de comprensión inmediata sólo por su nombre. Si yo fuera un novato, no sabría qué colocar allí. Tendría que usarla en una ZDP para deducirlo. --Canopus49 Responder 18:09 19 oct 2012 (UTC)
- Bien, gracias por hacerme notar las falencias de la mía, me ayuda a mejorarla y a darme cuenta de lo que pasé por alto. Ante este caso agregué un segundo parámetro, que permite dar detalles sobre lo que el primer parámetro dice. Volviendo al tema de esta plantilla, como expliqué en la plantilla, valga la redundancia, hay parámetros como "h1", "rank", etc. que no son de comprensión inmediata sólo por su nombre. Si yo fuera un novato, no sabría qué colocar allí. Tendría que usarla en una ZDP para deducirlo. --Canopus49
- Lo que quiero decir es que no creo que la documentación esté necesariamente incompleta: hay un enlace que acaba por explicarla, y cuyo contenido puede que resulte demasiado extenso como para que sea incluido en la documentación directamente... no digo que así sea: digo que este, como otros, son casos relativos, donde para algunos puede no ser la mejor manera de documentar, pero para otros sí; es preciso encontrar consensos y llegar a un estándar, de acuerdo, pero el que la documentación así como está sea "deficiente", en los términos actuales, creo que es una exageración. Saludos, Farisori » 17:11 19 oct 2012 (UTC)
