Document features

[koxudaxi]

add documents include examples on each feature.

[Prashanna313]

Interested to contribute

[femabeh]

Hey,
Currently the 'generate' method is not good documented, so if you want to use it (as module), you rely on the website that is also not great documentation.
I had multiple issues because i didn't know what to pass as variable (example: you can pass a string with file-content, file-path or folder-path to the 'input_' variable with very different behavior).

Please add a description for the variables in the code and add example to the website.

The 'generate' method could have a description like:

def generate(input_: str | Path, ...) -> None:
    """
        Generate Python data models from schema definitions or structured data

        :param input_: The content of the file, an Path to a file ($ref resolution inside the file), a Path to a directory (execution for each file inside, $ref resolution as imports)
        ...
    """