Skip to content

Update potentially confusing sample_duration explanation - #3559

Open
ethancrawford wants to merge 1 commit into
sonic-pi-net:devfrom
ethancrawford:amen-break-duration-docs-fix
Open

Update potentially confusing sample_duration explanation#3559
ethancrawford wants to merge 1 commit into
sonic-pi-net:devfrom
ethancrawford:amen-break-duration-docs-fix

Conversation

@ethancrawford

Copy link
Copy Markdown
Collaborator

Given that recent changes have introduced live interactive code examples into the documentation, the code example in Tutorial 3.4 for printing out a sample_duration can be potentially confusing. If the user has their global tempo set to something other than the default 60 BPM and runs this interactive example, a different value is printed out in the log panel to the one revealed in the tutorial.

To fix this, the tutorial now explains the output of this specific example in the context of the default 60 BPM tempo.

Additionally, the explanation now talks about sample_duration's output being returned as BPM rather than seconds.

Given that recent changes have introduced live interactive code examples into
the documentation, the code example in Tutorial 3.4 for printing out a
sample_duration can be potentially confusing. If the user has their global tempo
set to something other than the default 60 BPM and runs this interactive
example, a different value is printed out in the log panel to the one revealed
in the tutorial.

To fix this, the tutorial now explains the output of this specific example in
the context of the default 60 BPM tempo.

Additionally, the explanation now talks about sample_duration's output being
returned as BPM rather than seconds.
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

Successfully merging this pull request may close these issues.

1 participant