Update examples

[oz123]

This is a partial fix for #884 which addresses the first two bullet points.

[micw523]

Do you want to rework the yaml example though? Or are you using automodule on the utils/ package? I don’t think we have documentation about the creation from yaml otherwise

[oz123]

@micw523 can you be more specific please with your comment? I don't want to address all examples at once.
I just want to commit these two updated examples.
A follow up PR will add an example for kubernetes.util.create_from_yaml

[micw523]

I just saw that you took off the yaml example. However Sphinx allows us to create automated documentation of the utils/ folder and package with automodule/autoclass. I was wondering if that was your intention after removing the yaml example.

[oz123]

@micw523 that was not my intention. This pull request is only about updating the examples. I also included them in the sphinx docs.
Long term speaking, I would like to add more documentation inside the modules,
and there is also this issue swagger-api/swagger-codegen#9630.
Is there something specific you want me to include in this PR?

[micw523]

This sounds good to me. @roycaihw what do you think?

[yliaog]

/assign @micw523
/assign @roycaihw

[micw523]

/lgtm
Seems like I cannot call tide by using the robot?

[roycaihw]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: oz123, roycaihw

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [roycaihw]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment