HISE Logo Forum
    • Categories
    • Register
    • Login

    Better workflow for editing docs

    Scheduled Pinned Locked Moved Documentation
    6 Posts 5 Posters 277 Views
    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.
    • Christoph HartC
      Christoph Hart
      last edited by

      So one of the key takeaways of the first HISE meetup was that there should be less friction for people that want to contribute to the HISE documentation, which is sometimes

      1. sparse and
      2. written too complicated

      We talked about ways of solving this and somehow settled on me trying to explain to anybody that is interested how to use the delicate but super convoluted setup that merges autogenerated parts with custom docs to the content you see on the docs website.

      BUT

      that's nonsense. So instead I've added links to directly edit the file on the GitHub documentations to:

      1. Every site's footer (on the HTML version and the doc window inside HISE)
      2. Every undocumented API method in the Scripting API

      For the second thing to work I had to autocreate all files for the methods, but now it should create this flow of thoughts in your head everytime you try to use the docs.

      1. "Let me see what this function does"
      2. "Good. A one liner explanation. Would be great if someone adds more context"
      3. "Wait, I can add more context."
      4. Smash that edit button, hack away into the online markdown editor, commit the change or create a pull request. If you're not sure if the explanation you wrote in there is 100% correct, don't worry as I will proof read every pull request before merging.
      5. The next user will thank you.

      There are still a few pages which do not have a markdown file yet, but if you find one, let me know then I'll run the autogenerator again for this category.

      clevername27C LindonL A Matt_SFM 4 Replies Last reply Reply Quote 7
      • clevername27C
        clevername27 @Christoph Hart
        last edited by clevername27

        @Christoph-Hart - All the docs that say, "Just ask @d-healey" are me. (And the one that says, "First!") I'm helping.

        1 Reply Last reply Reply Quote 0
        • LindonL
          Lindon @Christoph Hart
          last edited by

          @Christoph-Hart Ok great, now how do I create whole new pages? for example a definition of what the tempofactor values are in "normal" and extended tempo set ups?

          HISE Development for hire.
          www.channelrobot.com

          1 Reply Last reply Reply Quote 1
          • A
            aaronventure @Christoph Hart
            last edited by

            @Christoph-Hart Nice. Some still missing are Engine.createBroadcaster, Engine.addModuleStateToUserPreset, BeatportManager.validate, most of the Array class... That's just what I've seen on a very quick skim.

            Christoph HartC 1 Reply Last reply Reply Quote 0
            • Christoph HartC
              Christoph Hart @aaronventure
              last edited by

              @aaronventure said in Better workflow for editing docs:

              Some still missing are Engine.createBroadcaster, Engine.addModuleStateToUserPreset,

              Haha that's a misunderstanding: I've deliberately omitted the link for docs that have already a description, it just shows the link for undocumented methods. The main goal is to fill up the blanks and nudge everyone towards that goal :)

              1 Reply Last reply Reply Quote 1
              • Matt_SFM
                Matt_SF @Christoph Hart
                last edited by

                @Christoph-Hart said in Better workflow for editing docs:

                There are still a few pages which do not have a markdown file yet, but if you find one, let me know then I'll run the autogenerator again for this category.

                The scriptnode's clone node has a markdown page but not the other clone-related nodes:
                container.clone_forward
                container.clone_cable
                container.clone_pack

                Develop branch
                Win10 & VS17 / Ventura & Xcode 14. 3

                1 Reply Last reply Reply Quote 1
                • First post
                  Last post

                30

                Online

                1.7k

                Users

                11.8k

                Topics

                102.7k

                Posts