Skip to content

Added link to Web Speech API article written by the Pipe team#38930

Closed
remusnegrota wants to merge 1 commit intomdn:mainfrom
remusnegrota:patch-1
Closed

Added link to Web Speech API article written by the Pipe team#38930
remusnegrota wants to merge 1 commit intomdn:mainfrom
remusnegrota:patch-1

Conversation

@remusnegrota
Copy link
Copy Markdown

Description

A link to a comprehensive article which covers all the aspects of the Web Speech API together with fully working code examples for both Speech Recognition and Speech Synthesis

Motivation

Added a link to an article written by us (addpipe.com)

Additional details

The article provides additional context on how to implement the Web Speech API and what kind of use cases this API could enable.
This is part of our publishing effort for the article that we've written.

Related issues and pull requests

A link to a comprehensive article which covers all the aspects of  the Web Speech API together with fully working code examples for both Speech Recognition and Speech Synthesis
@remusnegrota remusnegrota requested a review from a team as a code owner April 2, 2025 10:13
@remusnegrota remusnegrota requested review from wbamberg and removed request for a team April 2, 2025 10:13
@github-actions github-actions bot added Content:WebAPI Web API docs size/xs [PR only] 0-5 LoC changed labels Apr 2, 2025
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 4, 2025

Preview URLs

External URLs (1)

URL: /en-US/docs/Web/API/Web_Speech_API
Title: Web Speech API

@wbamberg
Copy link
Copy Markdown
Collaborator

wbamberg commented Apr 4, 2025

Thanks for your PR!

We're very conservative about adding external links to MDN, as our experience is that they are often not actively maintained. We do have an external link policy at https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#external_links. I'm not sure it meets the criteria for "good external links" there:

You should prefer adding links to external content that is:

  • Unique or indispensable (e.g., an IETF RFC)
  • Necessary for attribution, citation, or acknowledgement (e.g., as part of a Creative Commons attribution)
  • More likely to be maintained for the topic than incorporating such content on MDN Web Docs itself (e.g., a vendor's release notes)
  • Open source or community-driven, like MDN Web Docs itself

That is, while your post is a good article about the API, I'm not sure what it adds that isn't on MDN already. (FWIW I feel the same way about the other external links in this page, and would actively remove at least the HTML5Rocks one).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/xs [PR only] 0-5 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants