Skip to content

Conversation

@Convly
Copy link
Member

@Convly Convly commented Oct 18, 2024

What does it do?

Add the first version for the first typescript guide in the documentation

Why is it needed?

Part of our effort to ease the adoption of TypeScript in Strapi

Created new markdown files for API Reference and Guides under TypeScript development. Updated sidebar configuration to include these new sections and added corresponding links and placeholders.
This guide covers prerequisites, type imports, and usage examples for working with Strapi documents and components using TypeScript. It includes detailed sections on generic and known entities, advanced use-cases, and type argument inference to enhance type safety and development efficiency.
Updated the tags in the TypeScript development documentation to include 'api reference' and 'guides' for better categorization and easier navigation. This helps users find relevant information more efficiently.
@Convly Convly added source: Dev Docs PRs/issues targeting the Developer Docs internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections labels Oct 18, 2024
@vercel
Copy link

vercel bot commented Oct 18, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
documentation ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 6, 2024 1:30pm
Copy link
Collaborator

@pwizla pwizla left a comment

Choose a reason for hiding this comment

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

Thank you, JS! Super useful changes.

I left lots of purely technical writing-oriented comments.
Happy to discuss things with you if you want, or just apply most of them, depending on what you prefer 🤗

- reference
---

# API Reference
Copy link
Collaborator

@pwizla pwizla Oct 21, 2024

Choose a reason for hiding this comment

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

Until this page has some more content, I'd suggest we don't link to it from the sidebar and the TypeScript intro. page.

If you want to inform users that an API reference is in the works, I'd suggest you use the special :::strapi callout in the TypeScript development intro. page.

See my comment in the TypeScript development file :)

Copy link
Collaborator

Choose a reason for hiding this comment

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

Sorry, just taking over here while @Convly is off and don't fully understand what we would need to change. Could you update it the way you think would work best?

@pwizla pwizla self-assigned this Oct 21, 2024
@pwizla pwizla added this to the 5.1.4 milestone Oct 23, 2024
Convly and others added 3 commits October 23, 2024 18:06
…ts-and-entries.md Co-authored-by: Pierre Wizla <pwizla@users.noreply.github.com>
…ts-and-entries.md Co-authored-by: Pierre Wizla <pwizla@users.noreply.github.com>
…ts-and-entries.md Co-authored-by: Pierre Wizla <pwizla@users.noreply.github.com>
Convly and others added 2 commits October 23, 2024 18:09
Co-authored-by: Pierre Wizla <pwizla@users.noreply.github.com>
Co-authored-by: Pierre Wizla <pwizla@users.noreply.github.com>
Copy link
Collaborator

@innerdvations innerdvations 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 so far, just had some of the same comments as Piwi had

@meganelacheny meganelacheny merged commit 90230a4 into main Nov 6, 2024
3 checks passed
@meganelacheny meganelacheny deleted the enhancement/typescript-guides branch November 6, 2024 15:31
@pwizla pwizla added the temp - port to docs-next (Temporary label) The content of this PR should be ported to docs-next.strapi.io label Nov 13, 2024
@pwizla pwizla removed the temp - port to docs-next (Temporary label) The content of this PR should be ported to docs-next.strapi.io label Dec 10, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: new content PRs for new product features or new documentation sections source: Dev Docs PRs/issues targeting the Developer Docs

4 participants