Co-authored-by: James Harris <wopian@wopian.me>
4.8 KiB
Contributing
🎌 Čeština, Deutsch, English, Español, Français, Kurdi, Nederlands, Português, Türkçe, العربية, Ελληνικά, 日本語, 正體中文, 简体中文, 한국어
El código fuente en este repositorio se digitalizó manualmente a partir de impresiones en papel, por lo que los errores tipográficos y otras discrepancias se han introducido accidentalmente. El código se modificará para que sea coherente con las impresiones escaneadas:
Extensiones Útiles
GitHub tiene soporte de sintaxis para el lenguaje ensamblador AGC incorporado. Lamentablemente, su editor de código no lo hará, sin embargo, hay extensiones de lenguaje AGC que proporcionan resaltado de sintaxis para los siguientes editores:
- Atom†
- CodeBlocks
- Eclipse
- Kate
- ProgrammersNotepad
- Sublime Text 3†
- TextPad
- Vim
- Visual Studio Code†
- jEdit
† Admite formateo automático
Formateo
Nota: GitHub y las extensiones marcadas anteriormente asegurarán que esté utilizando el formato correcto automáticamente.
- Usar sangría de tabulación
- Use un ancho de pestaña de 8
- Recortar espacios en blanco al final
¿Qué verifico?
Cualquier discrepancia entre los escaneos y el código fuente en este repositorio, incluyendo:
Comentarios
- Los comentarios en el código transcrito deben coincidir exactamente con los escaneos
- Esto podría implicar crear un error tipográfico deliberado o eliminar / agregar un comentario completo.
Saltos de línea
- Salto de línea with
R0000
en la columna 1 debe coincidir exactamente con los escaneos. - Salto de línea with*out*
R0000
en la columna 1 debe contener solo 1 ó 2 líneas en blanco en una fila.- Si hay más de 2 saltos de línea en blanco, elimine los saltos de línea adicionales.
- Líneas con
R0000
en la columna 1 no cuentan para esto.
- Líneas con
- En las imágenes de origen, éstas fueron creadas por un dígito sin imprimir en la columna 8. A 2 forzó un doble espacio (línea en blanco simple) y un 3 forzó un espacio triple (línea en blanco doble). Los valores 4-8 se definieron pero nunca se usaron. Lea más sobre esto en #159
- Si hay más de 2 saltos de línea en blanco, elimine los saltos de línea adicionales.
Por ejemplo lo siguiente:
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
Debe convertirse:
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
Espacios
- Los espacios entre dos caracteres en la cadena deben respetar la siguiente convención (vea la discusión en #316):
- Espacio único para nuevas palabras.
- Doble espacio para nuevas oraciones.
- Triple espacio para hendiduras.
Por ejemplo lo siguiente:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Debe convertirse:
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
Nota
Antes de hacer un RP, ¡asegúrese de que sus cambios sean consistentes con los escaneos!