Scribd Logo
Cargar

¡Te damos la bienvenida a Scribd!

  • N1 - 9 - Estilo de Programación

    Cargado por

    Alexander Durán
    12 vistas6 páginas
    El documento describe seis aspectos importantes del estilo de programación: 1) usar nombres claros y estándares para variables y funciones, 2) incluir documentación completa para funciones, 3) mantener instrucciones sencillas y descomponer código en funciones con un solo propósito, 4) usar tipado de funciones y parámetros opcionalmente, 5) agregar comentarios para explicar fragmentos significativos pero no traducir el código, y 6) en general, hacer el código fácil de entender y mantener.

    Descripción original:

    Título original

    N1_9_Estilo de programación

    Derechos de autor

    © © All Rights Reserved

    Formatos disponibles

    PDF, TXT o lea en línea desde Scribd

    ¿Le pareció útil este documento?

    ¿Este contenido es inapropiado?

    Denunciar este documento
    El documento describe seis aspectos importantes del estilo de programación: 1) usar nombres claros y estándares para variables y funciones, 2) incluir documentación completa para funciones, 3) mantener instrucciones sencillas y descomponer código en funciones con un solo propósito, 4) usar tipado de funciones y parámetros opcionalmente, 5) agregar comentarios para explicar fragmentos significativos pero no traducir el código, y 6) en general, hacer el código fácil de entender y mantener.

    Copyright:

    © All Rights Reserved
    Descargue como PDF, TXT o lea en línea desde Scribd
    Marcar por contenido inapropiado
    12 vistas6 páginas

    N1 - 9 - Estilo de Programación

    Cargado por

    Alexander Durán
    El documento describe seis aspectos importantes del estilo de programación: 1) usar nombres claros y estándares para variables y funciones, 2) incluir documentación completa para funciones, 3) mantener instrucciones sencillas y descomponer código en funciones con un solo propósito, 4) usar tipado de funciones y parámetros opcionalmente, 5) agregar comentarios para explicar fragmentos significativos pero no traducir el código, y 6) en general, hacer el código fácil de entender y mantener.

    Copyright:

    © All Rights Reserved
    Descargue como PDF, TXT o lea en línea desde Scribd
    Marcar por contenido inapropiado
    de 6

    NIVEL 1

    ESTILO DE PROGRAMACIÓN
    N1

    PARA TENER EN CUENTA


    Estilo Responsabilidad

    Hay muchas formas en las


    que se puede escribir el El código que escribamos
    mismo programa: hoy posiblemente nos va
    • Incluir comentarios acompañar por mucho
    adicionales tiempo
    • Cambiar nombres de las
    variables y de las funciones
    • Cambiar la descomposición Hacerlo fácil de entender
    en funciones (mantenibilidad)

    2
    N1

    6 ASPECTOS
    Nombramiento de Para los nombres utiliza
    variables y funciones estándares
    - Utilice nombres claros, qué es - Uso de mayúsculas, minúsculas
    lo que van a guardar la variable y nombres compuesto
    - Evite nombres muy cortos En Python:
    (ambigüedad) - El carácter _ para separar las
    - Para las funciones utilice palabras
    nombres que indiquen lo qué - Los identificadores se escriben
    hace la función en minúscula
    (calcular_area_triangulo ó - Alfabeto inglés para evitar
    problemas de codificación
    area_triangulo)

    3
    N1

    6 ASPECTOS
    Documentación de funciones
    Formato consistente que incluya:
    - Descripción: objetivo de la función
    - Parámetros: nombre y tipo de cada uno con una breve descripción
    - Retorno: descripción de lo que retorna la función y su tipo

    4
    N1

    6 ASPECTOS
    Complejidad de las Descomposición de
    instrucciones funciones

    -Instrucciones sencillas, -Un único objetivo


    así sea un poco más
    largo -Fáciles de explicar
    -Idealmente, cada línea -Si repite código en
    solo debería hacer una varios bloques de su
    cosa programa, puede ser
    una función
    5
    N1

    6 ASPECTOS
    Tipado de funciones y Comentarios dentro de
    de parámetros las instrucciones
    - No exagere, el exceso puede
    Los type-hints son opcionales hacer el código difícil de leer
    en Python, sin embargo, - Escriba comentarios que
    nosotros los usamos: expliquen fragmentos
    significativos, no una traducción
    de Python a español
    - El código el más legible y - Identifique instrucciones
    fácil de usar complicadas y documéntelas
    - Nos prepara para utilizar - En funciones medianas o largas,
    otros lenguajes enumere las etapas con
    comentarios
    6

    También podría gustarte