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

docs: update drawTexture typedoc #5641

Merged
merged 6 commits into from
Sep 19, 2023
Merged

docs: update drawTexture typedoc #5641

merged 6 commits into from
Sep 19, 2023

Conversation

epreston
Copy link
Contributor

@epreston epreston commented Sep 17, 2023

This is a small test PR to ensure the process / method is correct.

Addresses warning:

[warning] Failed to resolve link to "GraphicsDevice#getCopyShader" in comment for drawTexture.shader.

Jsdocs location: pc.drawTexture
Typedocs location: drawTexture

The reference does not exist on GraphicsDevice. On WebglGraphicsDevice, it's marked as ignored so links do not work in jsdocs or typedocs.

This assumes the link should be kept. Removing the "ignore" documents "getCopyShader" in both tools.
Should the "ignore" be honoured and link removed ?

It is documenting the default value.

Notes:

  • getCopyShader only exists on WebglGraphicsDevice
  • drawTexture only supports WebGL device
  • The link reference only works if it is not ignored.

Fixes jsdoc link, typedoc link, removes typedoc warning.

I confirm I have read the contributing guidelines and signed the Contributor License Agreement.

Fix typedoc warning.

[warning] Failed to resolve link to "GraphicsDevice#getCopyShader" in comment for drawTexture.shader.

getCopyShader only exists on WebglGraphicsDevice

drawTexture only supports WebGL device
The link reference only works if it is not ignored.
@willeastcott willeastcott merged commit 4eed323 into playcanvas:main Sep 19, 2023
7 checks passed
@epreston epreston deleted the typedoc-warnings branch October 14, 2023 10:36
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

3 participants