Skip to content

Conversation

nicksanford
Copy link
Member

@nicksanford nicksanford commented Dec 7, 2023

Ticket

Depends on:
viamrobotics/rdk#3303
viamrobotics/viam-python-sdk#496

Scope doc link: https://viam.atlassian.net/browse/RSDK-4443

  • Update motion docs to describe new motion API
  • Update motion.MoveOnGlobe description, including new request & response values & new non blocking semantics
  • Add motion.StopPlan description
  • Add motion.GetPlan description
  • Add motion.ListPlanStatuses description

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Dec 7, 2023
@viambot
Copy link
Member

viambot commented Dec 7, 2023

Overall readability score: 56.59 (🟢 +0.02)

File Readability
_index.md 60.41 (🟢 +0.73)
motion.md 69.86 (🟢 +8.55)
View detailed metrics

🟢 - Shows an increase in readability
🔴 - Shows a decrease in readability

File Readability FRE GF ARI CLI DCRS
_index.md 60.41 38.72 8.41 13.8 13.69 5.88
  🟢 +0.73 🟢 +0.2 🟢 +0.21 🟢 +0 🔴 -0.06 🟢 +0.13
motion.md 69.86 60.72 9.15 7.8 9.61 8.18
  🟢 +8.55 🟢 +8.46 🟢 +1.04 🟢 +1 🟢 +0.75 🟢 +0.89

Averages:

  Readability FRE GF ARI CLI DCRS
Average 56.59 48.55 10.49 12.91 11.91 7.65
  🟢 +0.02 🟢 +0.02 🟢 +0 🟢 +0 🟢 +0 🟢 +0
View metric targets
Metric Range Ideal score
Flesch Reading Ease 100 (very easy read) to 0 (extremely difficult read) 60
Gunning Fog 6 (very easy read) to 17 (extremely difficult read) 8 or less
Auto. Read. Index 6 (very easy read) to 14 (extremely difficult read) 8 or less
Coleman Liau Index 6 (very easy read) to 17 (extremely difficult read) 8 or less
Dale-Chall Readability 4.9 (very easy read) to 9.9 (extremely difficult read) 6.9 or less

Copy link
Collaborator

@npentrel npentrel left a comment

Choose a reason for hiding this comment

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

Thanks for making these changes! I've made some minor changes to copy - please let me know if any of this makes it technically inaccurate and we can work on those

nicksanford and others added 6 commits December 8, 2023 10:48
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Co-authored-by: Naomi Pentrel <5212232+npentrel@users.noreply.github.com>
Copy link
Collaborator

@npentrel npentrel left a comment

Choose a reason for hiding this comment

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

Thanks!

Copy link
Member Author

@nicksanford nicksanford left a comment

Choose a reason for hiding this comment

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

@npentrel 2 more tweaks (sorry these are somewhat nuanced APIs). LMK if those look good.

@npentrel
Copy link
Collaborator

npentrel commented Dec 8, 2023

sounds good @nicksanford !

Copy link
Contributor

@raybjork raybjork left a comment

Choose a reason for hiding this comment

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

LGTM, just left a couple fixes

nicksanford and others added 3 commits December 11, 2023 17:42
Co-authored-by: Ray Bjorkman <raymond@viam.com>
Co-authored-by: Ray Bjorkman <raymond@viam.com>
nicksanford and others added 2 commits December 12, 2023 14:28
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Copy link
Contributor

@sguequierre sguequierre left a comment

Choose a reason for hiding this comment

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

This is almost ready to merge, just a couple small things!

nicksanford and others added 8 commits December 15, 2023 10:55
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
Copy link
Contributor

@sguequierre sguequierre left a comment

Choose a reason for hiding this comment

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

LGTM pending one last comment about return description!

Co-authored-by: Sierra Guequierre <sguequierre@gmail.com>
@viambot
Copy link
Member

viambot commented Dec 15, 2023

You can view a rendered version of the docs from this PR at https://docs-test.viam.dev/2310

@sguequierre sguequierre merged commit e773075 into viamrobotics:main Dec 21, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
safe to build This pull request is marked safe to build from a trusted zone
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants