kubernetes-client/python

Some suggestions for improvements to auto-generated docs

開放

#2,337 建立於 2025年1月27日

 (3 則留言) (0 個反應) (0 位負責人)Python (3,323 個分叉)batch import
help wantedkind/documentation

倉庫指標

星標
 (6,225 顆星)
PR 合併指標
 (PR 指標待抓取)

描述

I noticed a few minor improvements that can be made to the auto-generated docs. Admittedly, these changes are obvious for the user to make, but typically one expects examples to work out-of-the-box as much as possible.

  • The empty classes don't always work. For example, pass in a empty kubernetes.client.V1ServiceAccount() to replace_namespaced_service_account and you'll get an error the name of the object (name-example based on URL) was undeterminable: name must be provided. The class could use arguments or a message telling the user to provide arguments.
  • name does not follow kubernetes naming format, should have - instead of _
  • namespace does not follow kubernetes naming format, should have - instead of _

貢獻者指南