Greetings,

Wow! Thanks for the heads up on this. It is kind of shockingly sparse... and I think the docs are being incorrectly published for that library as well.

Anyway, I _think_ what the original author meant was for "dracclient" to be imported as "wsmanclient". The structure seems to match up with that. Looking at the existing code, it states "dracclient.client.DRACClient". That changed over four years ago so I think what you're viewing is a very old copy of the documentation that was once published in the openstack project namespace.

As for where, I don't think it is presently being published, which makes this problem ultimately worse. I'm going to reach out to the maintainers and inquire if they can fix the larger issue of their docs publishing.

Again, Thanks for the heads up.

-Julia

p.s. https://review.opendev.org/735674



On Mon, Jun 15, 2020 at 11:04 AM Ewan Hamilton <ewan.hamilton@managed.co.uk> wrote:

Hi guys,

 

Your documentation for python-dracclient begins here: https://docs.openstack.org/python-dracclient/latest/usage.html  with

 

 

Usage

Create a client object by providing the connection details of the DRAC card:

 

client = wsmanclient.client.DRACClient('1.2.3.4', 'username', 's3cr3t')

 

 

There is no import statement – and when I have searched google and found “import dracclient” because the assumed “import python-dracclient” doesn’t work due to a hyphen (why would you name your module with a hyphen in the first place?!), it doesn’t recognise “wsmanclient” in the editor still.

 

Can you see just how frustrating this is for someone who expects documentation that actually works and explains how to actually use the module?

 

This is a pathetic job here.

 

 

Ewan Hamilton​
3rd Line Networks Analyst
 t: 0800 033 4800  
ext. 2212 | 
m: 07772 001 625
LinkedIn
Twitter
Website
​Technology House, 151 Silbury Boulevard, Milton Keynes, MK9 1LH
managed. is a trading name of Managed247 Ltd
​Managed247 Ltd is a company registered in England and Wales under number 7019261