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

YouTubeThumbnail doc revision (DOC-458) #304

Merged
merged 23 commits into from
Feb 3, 2017
Merged

YouTubeThumbnail doc revision (DOC-458) #304

merged 23 commits into from
Feb 3, 2017

Conversation

fbeaudoincoveo
Copy link
Contributor

Deploy

fbeaudoincoveo and others added 23 commits January 16, 2017 17:35
I went a little bit further than a simple spell check for those first few components.
I will limit myself to a quick spell checks for the next components, though.
- Added link to IGroupByRequest interface.
- Made a tiny correction.
- Changed HTML link to markdown link.
- Reexposing selectSuggestion(suggestion: number) instead of selectSuggestion(suggestion: any) in public documentation.
…ation:

- "Standardized" bindings description in constructor documentation.
- Corrected a leftover spelling mistake.
- Some rephrasing and improvements.
- Unexposed options (this component has no option).
- Unexposed validLayouts static attribute (redundant with ValidLayout type) and currentLayout attribute (redundant with getCurrentLayout() method).
- Linked to ValidLayout type documentation.
*
* The default value is `200px`
* Default value is `200px`.
*/
Copy link
Contributor Author

@fbeaudoincoveo fbeaudoincoveo Feb 2, 2017

Choose a reason for hiding this comment

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

In the generated doc site, the markup configuration example is:
data-height='foo'
If possible, it would be better to display something like:
data-height='100px'

Copy link
Member

Choose a reason for hiding this comment

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

We would need to have a specific type for "Sizes", and then in the Typedoc project, have a way to recognize that type specifically and generate correct examples.

It would make a lot of sense to have a dedicated type for options that requires size. It would be helpful in the Interface Editor also.

If you are interested we can pass some time together and I can give you a crash course :)

*
* The default value is `112px`
* Default value is `112px`.
*/
Copy link
Contributor Author

Choose a reason for hiding this comment

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

See previous comment

@coveralls
Copy link

Coverage Status

Coverage remained the same at 75.861% when pulling 6a89c19 on fbeaudoincoveo:YouTubeThumbnailDocReview into 8a912b6 on coveo:master.

*
* The default value is `200px`
* Default value is `200px`.
*/
Copy link
Member

Choose a reason for hiding this comment

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

We would need to have a specific type for "Sizes", and then in the Typedoc project, have a way to recognize that type specifically and generate correct examples.

It would make a lot of sense to have a dedicated type for options that requires size. It would be helpful in the Interface Editor also.

If you are interested we can pass some time together and I can give you a crash course :)

@olamothe olamothe merged commit 51a9fee into coveo:master Feb 3, 2017
@fbeaudoincoveo fbeaudoincoveo deleted the YouTubeThumbnailDocReview branch February 3, 2017 18:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
3 participants