DOCS-1322: Suggest parameters, returns, descriptions for missing SDK methods

[sguequierre]

Pulling more info automated

[npentrel]

you currently look for all objects that have the type "sig sig-object py". I think you could instead look for objects that have the class "py method". Then you know that the first child which also has the class "sig sig-object py" is the object where you can get the id from. But, more importantly, the second child of that object has the description text. And then you can also get the parameters with their descriptions from that I think. Can you give that a go?

[npentrel]

Nice, now do you think you could change the formatting of the output to resemble what the docs need so that it's a simple copy and paste task?

[sguequierre]

Nice, now do you think you could change the formatting of the output to resemble what the docs need so that it's a simple copy and paste task?

@npentrel Tried to format it the best I can think of, LMK what you think!

[npentrel]

So this is an example of what you're getting as the output

Method: viam.services.slam.client.SLAMClient.get_latest_map_info 
 Method Parameters, Returned, Description: 
Get the timestamp of the last update to the point cloud SLAM map. 
  -The timestamp of the last update. 
  -datetime

I think pulling the pieces apart and adding the markup we need for the docs should work to create something like the following output. The close we can get to something we can just copy and paste and have it work, the better

Get the timestamp of the last update to the point cloud SLAM map.

**Parameters:**
- `timeout` (Optional[float]):

**Returns:**
- `datetime` (datetime.datetime): The timestamp of the last update.

For more information, see the [Python SDK Docs](URL - which I think you can also get).

[sguequierre]

Thank you, that makes sense! @npentrel I tried to update it to match your sample but this is the closest I could get it. They use relative links on the page and I couldn't figure out how to pull the method url precisely, tried a couple selectors, just looks like what we already have for ID so for URL I am using page url. That ok for now?

[viambot]

You can view a rendered version of the docs from this PR at https://docs-test.viam.dev/2087/public