Jump to content

  

7 members have voted

  1. 1. Documentation, how do you like it?

    • Online only
      0
    • Included with software
      1
    • Both online and included
      6

  • Please sign in to vote in this poll.

Recommended Posts

Hi peeps!

 

I have been thinking about moving the documentation for the Sound Engine into an online format rather than a hefty PDF included with the releases. Not really fan of maintaining multiple parallel versions of things so want it to be one or the other. At the moment I am playing with simply dumping the docs onto our website in as close as possible style as the PDF is.

 

My post here is to ask you, the people for your thoughts?

 

I am working on an online version of the docs at the moment, it's a bit messy as I have to go through tweaking formatting etc, but if you could have a lookie and let me know your thoughts? https://www.u-235.co.uk/developer/sound-engine/documentation/v0-24/

 

If you wish it would be interesting to hear what formats you would prefer your documentation in (for local docs).

 

I did consider Doxygen etc, but figure that's going to require me going and putting walls of text into the source (which is already hefty enough) plus they all seem to support specific languages, as this is a binary release software not sure they work well.

 

Thanks

Link to comment
https://forums.atariage.com/topic/290416-u-235-soundengine-documentation/
Share on other sites

  • 1 month later...

Online documentation is looking good. Seems to be much more clearly laid out than the .pdf (from memory). Maybe you could just supply an html version of the documentation with each current release of the soundengine. I would prefer to load up the offline version of the documentation, the version that goes with the version of the soundengine that I am using (iyswim). Thank you for your effort!

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Loading...
  • Recently Browsing   0 members

    • No registered users viewing this page.
×
×
  • Create New...