Improve dosctrings for DataSources (#1808)

* restart the changes: DataSources class typehints and description

* restauring pauls pipeline checks changes

* :?

* type hint?

* data sources class updated

* erase my local build

* restart the changes: DataSources class typehints and description

* restauring pauls pipeline checks changes

* :?

* type hint?

* data sources class updated

* erase my local build

* re-restauring pauls pipelines changes

* Update .github/workflows/docs.yml

* Update .github/workflows/docs.yml

* changes in the set_result_file_path function

* changes in the guess_result_key function

* changes in the guess_second_key function

* changes in the set_domain_result_file_path function

* changes in the add_file path and add_domain_file_path functions

* changes in the add_upstream path and add_domain_file_path functions

* changes in the add_upstream_for_domain function

* changes in the result_key property method

* changes in the result_files property method

* changes in the register_namespace function

* changes in the add_file_path_for_specific_result function

* all tests

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Update src/ansys/dpf/core/data_sources.py

Co-authored-by: Paul Profizi <[email protected]>

* Updates

* Fix docstring example for DataSources.add_upstream_for_domain()

* Fix docstring example for DataSources.add_upstream_for_domain()

* Fix expected paths in docstring examples

---------

Co-authored-by: luisaFelixSalles <[email protected]>

Author: PProfizi