Skip to content
This repository has been archived by the owner on Aug 13, 2023. It is now read-only.

Update psammead-media-player prop documentation #2545

Merged
merged 27 commits into from
Nov 6, 2019
Merged

Conversation

RayNjeri
Copy link
Contributor

@RayNjeri RayNjeri commented Nov 4, 2019

Signed-off-by: RayNjeri rachael.njeri@andela.com

Resolves #2475

Overall change: Updates @psammead-media-player Props documentation .

Code changes:

  • Updates @psammead-media-player README.md.

  • I have assigned myself to this PR and the corresponding issues
  • Automated jest tests added (for new features) or updated (for existing features)
  • This PR requires manual testing

Signed-off-by: RayNjeri <rachael.njeri@andela.com>
@RayNjeri RayNjeri self-assigned this Nov 4, 2019
@RayNjeri RayNjeri added articles-av-epic ws-articles Tasks for the WS Articles Team labels Nov 4, 2019
RayNjeri added 5 commits November 4, 2019 15:33

The `src` prop is required, as it tells the component what page it needs to embed.
The `placeholderSrcset` prop is not required, as it allows image responsiveness and optimization depending on the size of the screen.
The `title` prop is required for accessibility of the embedded iframe.
The `portrait` prop is not required, and defaults to `false`. This is to support portrait video content in the future.
The `mediaInfo` prop is required, as it shows info regarding the media such as title, duration, durationSpoken and type of media either Video or Audio
Copy link
Contributor

@jamesdonoh jamesdonoh Nov 4, 2019

Choose a reason for hiding this comment

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

I think we should add another table documenting the constituent properties of the mediaInfo object and whether they are required etc. following the propType defined at https://github.com/bbc/psammead/blob/0be6fee4b760960535d08b9260c44d4ed1604942/packages/components/psammead-media-player/src/index.jsx#L88

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done

RayNjeri added 2 commits November 4, 2019 18:59
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Copy link
Contributor

@simonsinclair simonsinclair 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 updating this, @RayNjeri! Please can you add skin and service too?

packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
simonsinclair and others added 4 commits November 4, 2019 20:19
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
…5-documentation

Signed-off-by: RayNjeri <rachael.njeri@andela.com>
RayNjeri added 2 commits November 5, 2019 10:47
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
@RayNjeri RayNjeri requested a review from Bopchy November 5, 2019 13:28
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Copy link
Contributor

@Bopchy Bopchy left a comment

Choose a reason for hiding this comment

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

Looks good 👍

Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Rachael Njeri and others added 4 commits November 6, 2019 11:13
Co-Authored-By: Simon Sinclair <simon.sinclair@bbc.co.uk>
Co-Authored-By: Simon Sinclair <simon.sinclair@bbc.co.uk>
Co-Authored-By: Simon Sinclair <simon.sinclair@bbc.co.uk>
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Copy link
Contributor

@HarveyPeachey HarveyPeachey 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 some things with string quotations

packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
packages/components/psammead-media-player/README.md Outdated Show resolved Hide resolved
Signed-off-by: RayNjeri <rachael.njeri@andela.com>
Co-Authored-By: Harvey Peachey <harvey.peachey@bbc.co.uk>
Copy link
Contributor

@HarveyPeachey HarveyPeachey left a comment

Choose a reason for hiding this comment

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

LGTM

@RayNjeri RayNjeri merged commit 71593a7 into latest Nov 6, 2019
@RayNjeri RayNjeri deleted the 2475-documentation branch November 6, 2019 10:23
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
articles-av-epic ws-articles Tasks for the WS Articles Team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update psammead-media-player prop documentation
6 participants