Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Where is the Scripting Guide? #53

Open
hoergen opened this issue Feb 6, 2023 · 8 comments
Open

Where is the Scripting Guide? #53

hoergen opened this issue Feb 6, 2023 · 8 comments

Comments

@hoergen
Copy link

hoergen commented Feb 6, 2023

"A scripting guide and API reference resides in Bitwig Studio under Help > Documentation > Developer Resources."

The Scripting Guide is no part any more in the current Bitwig versions. Where can I find the scripting guide?

@kirkwoodwest
Copy link

@aum7
Copy link

aum7 commented Dec 16, 2023

please, bitwig, either :

  • remove references to non-existing 'scripting guide', or
  • put the guide where it is claimed to be -> help - documentation, or
  • put it where we mortals would expect it - under api documentation :
    file:///opt/bitwig-studio/resources/doc/control-surface/api/index.html
    this is obviously local file

os : linux mint 21
bitwig : 5.1 latest & greatest

@AndyJBuchanan
Copy link

Seconded. The API ref mentions this guide on the first page and googling is awash with exhortations to get this document from the Help menu. Where it isn't.

@Lokua
Copy link

Lokua commented Jan 17, 2025

After upgrading Bitwig today, I find this absolutely infuriating.

@ohcibi
Copy link

ohcibi commented Feb 13, 2025

This issue needs higher priority. Javascript seems completely undocumented. Java only has the APIdoc (which seems outdated when following some of the deprecated noets) @abique @vosc @kurasu could you please say something about this? If there is nodocumentation about javascript, is there a repository for the library code? Such that we at least can have a look at the API and maybe even contribute some documentation?

It might also make sense to mark everything around controller scripting as beta or something similar (!nd as others have said, definitely remove the reference to non existing scripting guides. As a rule of thumb, don't reference other documents without a link. In other words: a reference to a document without a (working) link should become its own Jira Issue with at least default priority. If you want users to contribute to the incomplete controller support, you cannot ignore documentaiton.

@ohcibi
Copy link

ohcibi commented Feb 13, 2025

Best bet to follow the masterful multi-part series by moss. https://www.youtube.com/watch?v=l4AuiQ8krQc&list=PLqRWeSPiYQ66KBGONBenPv1O3luQCFQR2&ab_channel=J%C3%BCrgenMo%C3%9Fgraber

Just in case this isnt known. The video is 6 years old. Moss talks about api version 7. Bitwig today created an example project with loadAPI(20) in it. Moss' js framework was already outdated by the time of the video. (oh and in fact the missing scripting guide was in bitwig at the mentined place back then)

@kirkwoodwest
Copy link

kirkwoodwest commented Feb 13, 2025

Just in case this isnt known. The video is 6 years old. Moss talks about api version 7. Bitwig today created an example project with loadAPI(20) in it. Moss' js framework was already outdated by the time of the video. (oh and in fact the missing scripting guide was in bitwig at the mentined place back then)

The video is still 100% relevant. everything is done the same way. This is the scripting guide. Trust me on this when I say the video series is better than anything Bitwig has provided before. Run it at 2x if you have to.

API 20 isn't out yet... its just the Beta version generating that code. API 19 is the one to use until its updated in the Maven Repo.

@ohcibi
Copy link

ohcibi commented Feb 13, 2025

Just in case this isnt known. The video is 6 years old. Moss talks about api version 7. Bitwig today created an example project with loadAPI(20) in it. Moss' js framework was already outdated by the time of the video. (oh and in fact the missing scripting guide was in bitwig at the mentined place back then)

The video is still 100% relevant. everything is done the same way. This is the scripting guide. Trust me on this when I say the video series is better than anything Bitwig has provided before. Run it at 2x if you have to.

API 20 isn't out yet... its just the Beta version generating that code. API 19 is the one to use until its updated in the Maven Repo.

there is no need to jump in to defend this video as nobody is attacking it. Nobody asked nor questioned whether or not the video is relevant and nobody asked about how much relevant it is either. Also there certainly is no doubt that this video is better than what bitwig currently provides, which - newsflash - is the point of this issue. The legitimatility of this video however, is - in context of this issue - indeed entirely irrelevant, as we are not discussing this video here but how to (re)add the information to bitwigs official documentation

Run it at 2x if you have to.

Despite the fact that running a video 2x is not making it better than written documentation, I want to stress that this issue is not about that. Please do not add any more noise. We know the link. Thanks for sharing. But now lets make them maintainers fix the actual issue (or tell us how to help doing so)

API 20 isn't out yet... API 19

First of: its also irrelevant because my point was the huge difference... Second: it just adds to this issue which is about (re)adding the missing information to bitwig. In case I havent mentioned it yet.

@abique @vosc @kurasu the issue is neither solved nor brought any further since my last question.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

6 participants