react-native-windows-samples icon indicating copy to clipboard operation
react-native-windows-samples copied to clipboard

Add Fabric Props API Documentation

Open anupriya13 opened this issue 9 months ago • 3 comments

Page url

https://microsoft.github.io/react-native-windows/docs/flyout-component

Problem Description

All Fabric props like ScrollView, Image, etc Props API are missing!

anupriya13 avatar Apr 18 '25 08:04 anupriya13

Originally, it was an intentional choice on Paper to only document the props that were different from React Native core (i.e. Flyout, Popup, etc.). We could decide to document all of the components supported on Fabric, but this would be a change in our approach to our website documentation and would require A LOT of extra maintenance on our part.

We should have a discussion about whether this is what we want to do. @chrisglein @jonthysell tagging for comments.

chiaramooney avatar Apr 21 '25 17:04 chiaramooney

Documenting all props would be a lot of work and risk becoming out of date with Meta's documentation on the core website over time. They regularly make improvements there. So we'd need to maintain some sort of thoughtful fork/sync process for that. It's more reasonable to have this website not offer API documentation except when it has to (Windows-only types/props). The best developer experience would actually to have Windows-only props show up alongside the main docs like iOS-only and Android-only props, but that's tricky to scale as RN then has to support core and external props and that gets messy.

chrisglein avatar Apr 22 '25 00:04 chrisglein

Currently I don't see any way to figure out what props are available in React Native Windows Fabric and this can be challenging for developers. Hence, added the issue here. Please correct me if I am wrong.

Adding @vivekkhare31 to the thread too.

anupriya13 avatar Apr 22 '25 01:04 anupriya13