Lesson 5 

Much better, let's dissect it a bit, this is what you have:

    """Task 1 Assignment 5"""

    def bool_to_str(bvalue, short=False):
        """ This function will convert a boolean value of


        True or False to the string values of Yes
        or No

        Args:
        bvalue (bool): True or False.
        short (str, optional, default is False): if set to False
        function returns N or Y. If set True returns No or Yes

       returns:
       str: Yes, No, Y, or N

       Yes, No if short returns False
       y< N if short returns True

       Yes if bvalue = True
       No if bvalue = False

        """

Comments:

- two spaces between functions. the 'def' line is where the function is defined so the two spaces should be *above* that
- try to keep the first sentence short and ending with a period. Additional comments can appear after that.
- the actual arguments should be indented 4 spaces from the args header
- bvalue should tell me what this true/false represents, not necessarily its value -- what is bvalue doing here?
- your returns statement lost its indendation and no longer lines up
- returns should be capitalized (`Returns:`)
- the returns line should be indented from its header
- you need an examples header (`Examples:`)
- examples should be indented and directly copy how things look in the interpreter including the `>>>`

Together, they should resemble:

    """Task 1 Assignment 5"""
    
    
    def bool_to_str(bvalue, short=False):
        """ This function will convert a boolean value  to a string.
    
        Returned values can be optionally shortened to single-character
        equivalents.
    
        Args:
            bvalue (bool): The boolean that will be converted to a string.
            short (str, optional): If set to True, returns will be shortened to
                the first character (eg, ``Y`` or ``N``). Defaults to False.
        
        Returns:
            str: The converted boolean; ether ``Yes``, ``No``, ``Y`` or ``N``.
    
        Examples:
                >>> bool_to_str(True)
            'Yes'
    
            >>> bool_to_str(False)
            'No'
    
            >>> bool_to_str(bvalue=True, short=True)
            'Y'
        """