gee-community / geetools

A collection of tools to work with Google Earth Engine Python API
https://geetools.readthedocs.io/en/stable/
MIT License
530 stars 122 forks source link

tune documentation template to fit extention pattern #308

Open 12rambau opened 1 month ago

12rambau commented 1 month ago

Currently in the doccumentation, every page is showing the complete location of the function when every single one of them is actually attached to a GEE base object.

That would be great if the API reference pages instead of showing the internal shape of the lib was displaying how the methods are accecible to the user.

rahulmansharamani14 commented 1 month ago

Hi @12rambau, I'd like to work on this issue. Can you please assign it to me?

rahulmansharamani14 commented 1 month ago

@12rambau Currently, the API documentation shows the complete internal path to the functions. For example:

geetools.lib.something.function_name

Based on the issue description, it seems like the desired documentation should reflect how users actually access these methods via a GEE base object. So, instead of the internal module path, the documentation would show something like:

gee_object.function_name

Could you confirm if this is the expected change? If not, what is?

12rambau commented 1 month ago

actually it's more ee.gee_object.geetools.function_name as all the functions are hidden behind the geetools namespace. That is not true for 2 exceptions that I use on regular basis:

12rambau commented 1 month ago

BTW I'm positively surprised to see you offering your help, that's super nice. Since I rebooted this package that was basically me and Rodrigo alone working on it so I wasn't very careful with my issues. I'll make them more clear and professional from now on.