Skip to content

docs: add a Data Connect guide and link it from the README#3724

Open
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:data-connect-readme-doc
Open

docs: add a Data Connect guide and link it from the README#3724
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:data-connect-readme-doc

Conversation

@armando-navarro

Copy link
Copy Markdown
Collaborator

Adds a Data Connect guide and wires it into the README feature table.

Data Connect support already shipped in the library (the ng add schematics generate its config, #3638 and #3714), but there was no guide for it, and #3636 asked for exactly that. #3673 added a README table entry for Data Connect, but the entry linked to a docs/data-connect.md that did not exist (a dead link) and sat out of alphabetical order. This carries that contribution forward: it adds the missing guide and places the entry correctly. Credit to @maneesht for adding the entry and surfacing the gap.

What's here

  • docs/data-connect.md: a new guide following the same shape as the other product guides (intro, dependency-injection setup with provideDataConnect / getDataConnect and a connector config, then inject(DataConnect), and the standard "AngularFire wraps the Firebase JS SDK" note).
  • README.md: the Data Connect entry, placed alphabetically after Cloud Storage, with the feature table re-flowed into even two-column rows (this also fixes the previously lopsided final row).

Notes

  • Firebase now brands this product "Firebase SQL Connect". The guide keeps "Data Connect" as the primary name to match the @angular/fire/data-connect entry point and the DataConnect class, and notes the new branding inline.
  • The dependency-injection sample was checked against the installed @firebase/data-connect type definitions: getDataConnect(options: ConnectorConfig) is a real overload, and ConnectorConfig is { location, connector, service }.
  • Every link was verified live. There is no hosted JS/Web API reference page for Data Connect, so the guide links "Learn more" and "Getting Started" only, rather than a reference page that would 404.

Fixes #3636

Add docs/data-connect.md describing the Data Connect secondary entry
point, following the same shape as the other product guides: a short
intro, the dependency-injection setup (provideDataConnect/getDataConnect
with a connector config, then inject(DataConnect)), and the wrap-the-SDK
note.

Add the Data Connect entry to the README feature table in its
alphabetical slot after Cloud Storage, and re-flow the table into even
two-column rows, which also fixes the previously lopsided final row.

This supersedes angular#3673, which added the README entry but linked it to a
docs/data-connect.md that did not exist (a dead link) and placed the row
out of alphabetical order. Credit to @maneesht for adding the entry and
flagging the gap.

Firebase now brands this product "Firebase SQL Connect"; the guide keeps
"Data Connect" as the primary name to match the @angular/fire/data-connect
entry point and notes the new branding.
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.

Data connect

1 participant