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

Add platform/Span documentation. #683

Merged
merged 5 commits into from Aug 30, 2018
Merged

Conversation

pan-
Copy link
Member

@pan- pan- commented Aug 24, 2018

This is the associated documentation PR for ARMmbed/mbed-os#7828.

@pan-
Copy link
Member Author

pan- commented Aug 24, 2018

@donatieng Could you review ?

Copy edit, mostly for active voice.
Copy link
Contributor

@AnotherButler AnotherButler left a comment

Choose a reason for hiding this comment

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

I edited this for active voice. Please review it to make sure I didn't accidentally change the meaning of anything.

### Span class reference

[![View code](https://www.mbed.com/embed/?type=library)](https://os-doc-builder.test.mbed.com/docs/development/mbed-os-api-doxy/class_span.html)

Copy link
Contributor

Choose a reason for hiding this comment

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

Please add an example.

Copy link
Contributor

@donatieng donatieng left a comment

Choose a reason for hiding this comment

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

Great stuff @pan- - only that middle_half thing, otherwise the doc is good!


Span<uint8_t> first_half = str_span.first(half_size);
Span<uint8_t> second_half = str_span.last(half_size);
Span<uint8_t> middle_half = str_span.subspan(/* offset */ half_size / 2, half_size);
Copy link
Contributor

Choose a reason for hiding this comment

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

middle_half sounds a bit weird to me

@AnotherButler
Copy link
Contributor

@pan- Please address the comments from @donatieng

@ashok-rao
Copy link
Contributor

@pan- Question: why do all code snippets show uint8_t ? why not other bit lengths? not supported yet or these are just examples?

Copy link
Contributor

@ashok-rao ashok-rao left a comment

Choose a reason for hiding this comment

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

Just left a minor question..rest all LGTM! good work @pan- ..!

@pan-
Copy link
Member Author

pan- commented Aug 29, 2018

@ashok-rao Any type is supported, it is just for examples purposes.

Copy link
Contributor

@ashok-rao ashok-rao left a comment

Choose a reason for hiding this comment

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

Great..thanks @pan- ..nice one.

@pan-
Copy link
Member Author

pan- commented Aug 30, 2018

@donatieng I fixed your issue.
@AnotherButler I've added an example and referenced the page in platform.

Copy link
Contributor

@donatieng donatieng left a comment

Choose a reason for hiding this comment

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

Kudos for mentioning IQR ;)

@AnotherButler AnotherButler merged commit 907ff0f into ARMmbed:development Aug 30, 2018
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.

None yet

4 participants