> For the complete documentation index, see [llms.txt](https://pythonforstarters.solomonmarvel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://pythonforstarters.solomonmarvel.com/loop-...-else-clause-partial-functions-and-type-hints/type-hints.md).

# Type Hints

Type hints in Python are a way to specify the expected type of function's arguments and return value. They are a form of documentation that can be used to help developers understand and use the code, and they can also be used by static type checkers to detect type errors in the code.

They are completely optional and are not used by the interpreter to enforce any type checking. Instead, they are mainly used as a form of documentation to help other developers understand the code.

* Python’s type hints provide you with optional static typing to leverage the best of both static and dynamic typing.

Here's an example of type annotations in your python code:

```python
"""
The type descriptions are optional but it makes it 
easier for other developers to read your code and 
understand the types that you're working with
"""

name: str = "Marvelous"
number: int = 10

# using types to descript the parameter types and the function return type
def say_hi(name: str) -> str:
    return f'Hi {name}'

greeting = say_hi('Emanuella')
print(greeting)
```

Type annotations can be especially useful when working with large codebases or when collaborating with other developers. They can help to make the code more self-explanatory and easier to understand.

It's worth noting that type annotations are a relatively recent addition to Python (introduced in Python 3.0). Prior to the introduction of type annotations, developers used comments or documentation strings to describe the expected types of variables and expressions.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://pythonforstarters.solomonmarvel.com/loop-...-else-clause-partial-functions-and-type-hints/type-hints.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.