Que sea simple?

2plus2 Make it simple? La especificación es importante - esta afirmación es evidente para todos. Un producto ampliamente utilizado, la tecnología o el lenguaje sin una especificación es inútil. Una técnica sin un banco de pruebas es peligroso. Un banco de pruebas sin marcaje y pruebas es imposible. Este proceso es bastante complejo. Sin embargo, hay maneras de simplificar la etapa de marcado.

En cuanto a la especificación del lenguaje Java (JLS) y Java Specification máquina virtual (JVM) que están escritos en FrameMaker. Después de especificaciones se exporta a HTML y PDF. El marcado se incrusta en versión html. Mi opinión es que la información de marcado debe ser colocado en (o relacionado con) el texto origen. En nuestro caso es el documento FrameMaker. No estoy seguro de que esto es posible en absoluto, pero creo que es. Si no, tal vez FrameMaker no es la mejor solución. Como resultado, reducirá significativamente la cantidad de tiempo y el esfuerzo necesarios para la transferencia de marcas viejas y marcar un nuevo texto. Por otra parte durante la grabación de la próxima revisión de las especificaciones del autor junto con el equipo tck debe marcado todas chenged y nuevas afirmaciones. Yo diría que la mejor manera es cuando la escritura de especificaciones y los procesos de marcado se realizan al mismo tiempo. Es razonable que el autor señala que los desarrolladores probar lo que las declaraciones deben ser examinados.



, , , , , , , , , , , , , ,
  • Compartir / Guardar
Print This Post Imprimir este mensaje

Afirmación para colorear

rainbow Assertion coloring desarrollo de Conformidad prueba consiste en la identificación de las afirmaciones en un pliego, pruebas de conformidad por escrito que compruebe las afirmaciones identificados y la vinculación de la prueba de la afirmación de que lo pone a prueba.
Vamos a empezar desde los siguientes puntos:
- Afirmación está marcado
- La afirmación real es difícil ver en la especificación (en la actualidad sólo hay pequeñas gif afirmación al final de cada afirmación)
- Completa afirmaciones sólo son vistos por la lectura del código HTML directamente o buscando en cada prueba individual
- Inicio de las afirmaciones son difíciles de ver en el código html
- Proporcionar una forma visual para ver fácilmente la afirmación es el problema que estamos tratando de resolver.

El punto principal es que las afirmaciones de color (texto propio pliego de condiciones) con etiquetas HTML. La investigación que se hizo etiquetas html de usar. Div, span, mesa con etiquetas de fuente se miró. La mejor solución es la etiqueta de fuente. Así que el texto está rodeado con las etiquetas de la fuente. El atributo de clase de la etiqueta de fuente se corresponde con el tipo de afirmación. Fe si el asserion es nuevo es de color de rojo, para indicar, que las pruebas deben ser por escrito, las afirmaciones de edad se colorean con verde para indicar que las pruebas ya existentes. Debe haber una utilidad (java script o programa) para explorar marcado pliego de condiciones y automáticamente se añaden las etiquetas necesarias para colorear. El color de fondo del texto será determinado por el color atributo de título de la afirmación. Este método fue implementado y funciona correctamente. A efectos de la usabilidad, debe haber un mecanismo para ocultar la coloración, una fe Javascript.

Una desventaja de esta solución es que el color es estático ya que se basa en el atributo de título. Una segunda solución sería que el instrumento de verificación para una existencia de una prueba (basado en el ID de la afirmación o enlace en la afirmación). Si una prueba de que existe, queremos hacer algo para establecer el color de esta afirmación. Podría ser tan simple como el establecimiento de un atributo de título. Una desventaja de esta solución sería la afirmación de que la coloración se sigue estático, pero en base a cuando el usuario ejecute los scripts.

Una variante de la solución dada es que se generan de forma dinámica los datos de cobertura cuando la especificación es visto en un navegador. Queremos determinar si existe una prueba en el directorio de prueba para una afirmación y el color de la afirmación en consecuencia. Esto podría hacerse a través de un JavaScript / VBScript utilizando objetos, que permiten el acceso a sistema de archivos. Este método podría ser dinámica y siempre debe tener la condición última afirmación de la cobertura.

Éstos son algunos ejemplos de JLS3 capítulos "Conversiones y Promociones" y "Interfaces":

JLS3 colored Assertion coloring

JLS3 colored2 Assertion coloring

Las afirmaciones conv063, conv047, conv065, conv48, conv66 y conv049 son de la version anterior de las especificaciones, no se modificaron y actualizar las pruebas no es necesario - de color aguamarina es (verde neurtal). Conv155 y conv156 son nuevos, nuevas pruebas deben elaborarse, en las afirmaciones que están en el origen de color rojo. Conv064 fue modificada, es necesario actualizar la prueba - de color naranja. Annot019 es nuevo, las pruebas existen, pero son necesarias para cambiar - color salmón. Annot020 es nuevo, pero existen pruebas кудумфте - de color verde claro.

La principal ventaja de coloración en especifico es que la especificación se visualiza. El usuario puede ver la afirmación de todo y su título. Uno puede decir mirando a la especulación, donde hay áreas con baja cobertura, en algunos o muchos de los ensayos debe ser agregado o cambiado. Hay, básicamente, la posibilidad de ver qué tan bien una especificación es marcado y lo bien que se prueba.



, , , , , , ,
  • Compartir / Guardar
Print This Post Imprimir este mensaje

Marcado de metadatos

11 Markup metadata La definición más simple de los metadatos es que se trata de datos sobre los datos. Los metadatos pueden ser muy útiles. En cuanto a las marcas que había algunos metadatos incrustados: descripción id, pequeño de la afirmación, enlace a la prueba. Durante la transferencia de marcado me di cuenta de que más de metadatos sería muy útil. En la nueva versión de la especificación había varios tipos de afirmaciones:

  • edad:
    texto no cambia, las pruebas no es necesario ningún cambio;
  • oldToBeChanged:
    ha cambiado el texto, las pruebas tienen que ser cambiado;
  • nuevo:
    totalmente nuevo texto, nuevas pruebas necesarias;
  • newWritten:
    nuevo texto, pero las pruebas ya existentes (ya que el proceso de desarrollo de la prueba comenzó tan pronto como la especificación del proyecto está disponible);
  • newWrittenToBeChanged:
    nuevo texto, las pruebas existentes, el proyecto de especificaciones cambiado, así que las pruebas hay que cambiar o pruebas existentes no son suficientes.

La adición de este tipo de datos al margen de beneficio sería mucho más fácil el trabajo futuro - el desarrollo de las pruebas. Debido a que con sólo mirar una afirmación que figura en la especificación puede decir fácilmente si se necesitan más pruebas o más, deben actualizarse.

Con lo dado arquitectura de marcas es se decidió utilizar el atributo de título en una etiqueta href (el ancla segundo). Así que el margen de beneficio sería el resultado:

<a name=assertionID> <! - Descripción shord como comentario HTML ->
aseveración de los estados aquí
<img href="path <a src="pics/assert.gif"> a prueba test" title=assertType> ID que es lo mismo que la afirmación de identificación </ a>

El atributo title se puede ver en un navegador como una sugerencia.

JLS3 html Markup metadata

JLS3 html code Markup metadata



, , , , , , , , , ,
  • Compartir / Guardar
Print This Post Imprimir este mensaje