Skip to content

Sync README, docs and code behavior#490

Merged
WasabiFan merged 5 commits intoev3dev-stretchfrom
docs-cleanup-from-readme
Jul 29, 2018
Merged

Sync README, docs and code behavior#490
WasabiFan merged 5 commits intoev3dev-stretchfrom
docs-cleanup-from-readme

Conversation

@WasabiFan
Copy link
Copy Markdown
Member

@WasabiFan WasabiFan commented Jul 29, 2018

Also, minor improvement to LED parameter options.

The docs in the Sound class were quite badly formatted after going through Sphinx so I updated all of those methods to use the standard Sphinx/reST style which will be rendered properly. It would be nice to update other areas to do the same.

@WasabiFan WasabiFan requested a review from ddemidov July 29, 2018 04:34
Comment thread README.rst

sound = Sound()
sound.speak('Welcome to the E V 3 dev project!').wait()
sound.speak('Welcome to the E V 3 dev project!')
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I started to comment asking why did we remove this, when we still are returning Popen objects from Sound methods, then noticed we mostly don't anymore. The exception is beep, which still needs .wait() to make it synchronous. Should it be changed as well?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good point. I'll modify beep to match the behavior of the other methods.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've updated beep and its derivative tone, and in the process fixed the docs example because these methods aren't static anymore.

@WasabiFan WasabiFan merged commit 255cf5d into ev3dev-stretch Jul 29, 2018
@WasabiFan WasabiFan deleted the docs-cleanup-from-readme branch November 10, 2018 00:26
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.

2 participants