omz:forum

    • Register
    • Login
    • Search
    • Recent
    • Popular

    Welcome!

    This is the community forum for my apps Pythonista and Editorial.

    For individual support questions, you can also send an email. If you have a very short question or just want to say hello — I'm @olemoritz on Twitter.


    docgen - markdown documentation generator

    Pythonista
    2
    5
    2710
    Loading More Posts
    • Oldest to Newest
    • Newest to Oldest
    • Most Votes
    Reply
    • Reply as topic
    Log in to reply
    This topic has been deleted. Only users with topic management privileges can see it.
    • mikael
      mikael last edited by

      I have been told that you should not generate documentation from code, and there are probably several good reasons behind that guideline. However, for the specific purpose of documenting and testing the small-scale projects I have using Pythonista, I really prefer maintaining only the docstrings that are in the code, and then generating the markdown documentation for Github.

      docgen is a single-file utility that is intended to be run from the Pythonista action menu. Check the README file for usage.

      For "real-life" examples of the generated documentation, see the Scripter and Gestures docs.

      1 Reply Last reply Reply Quote 0
      • jmv38
        jmv38 last edited by

        hello. I get an error: line 111
        heading = f'Class: {c.name}'

        mikael 2 Replies Last reply Reply Quote 0
        • mikael
          mikael @jmv38 last edited by

          @jmv38, my bad, I forgot to mention that this is Python 3.6 code, only available in Pythonista beta at the moment.

          1 Reply Last reply Reply Quote 0
          • mikael
            mikael @jmv38 last edited by

            @jmv38, latest version no longer has the f-strings, so should be compatible with Python 3.5 and the App Store version of Pythonista.

            1 Reply Last reply Reply Quote 0
            • jmv38
              jmv38 last edited by

              thank you. It works fine now.

              1 Reply Last reply Reply Quote 0
              • First post
                Last post
              Powered by NodeBB Forums | Contributors