Uploaded image for project: 'ListenBrainz'
  1. ListenBrainz
  2. LB-1501

Improve documentation formatting of click commands

XMLWordPrintable

    • Icon: Improvement Improvement
    • Resolution: Fixed
    • Icon: Normal Normal
    • None
    • None

      We use sphinx-click to document cli commands automatically. sphinx-click relies on the documentation of the options and arguments to be mentioned as help text in the decorator instead of the docstring of the function.  This file needs to be modified.

      Here is an example of the wrongly formatted command,

      Note how args is mentioned below the command description and some options have no help text.

      Here is an example of a properly documented command,

            avnijainnn avnijainnn
            kartik1712 amCap1712
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved:

                Version Package