Add directing pages for unmaintained components (#1810)

* Add directing pages for unmaintained components

* Add missing example links

* Fixed typo

* Fix typo.. again

Author: ethanshar

docuilib/docusaurus.config.js

@@ -17,7 +17,7 @@ const darkCodeTheme = require('prism-react-renderer/themes/dracula');
     trailingSlash: false,
     customFields: {
       expoSnackLink: 'https://snack.expo.io/@ethanshar/rnuilib_snack?platform=ios&supportedPlatforms=ios,android',
-      stars: '4'
+      stars: '4.1'
     },
     plugins: ['docusaurus-plugin-sass'],
     presets: [

scripts/build-docs.js

@@ -26,15 +26,17 @@ const parentComponents = _.chain(compoundComponents)
 components.forEach(component => {
   const [componentName, componentParentName] = getComponentNameParts(component.name);
   const isParentComponent = parentComponents.includes(componentName);
+  const isIncubatorComponent = component.category === 'incubator';
 
   let content = '';
+
   /* Markdown Front Matter */
   content += `---\n`;
   if (isParentComponent) {
     content += `sidebar_position: 1\n`;
   }
   content += `id: ${component.name}\n`;
-  content += `title: ${component.name}\n`;
+  content += `title: ${isIncubatorComponent ? 'Incubator.' : ''}${component.name}\n`;
   content += `sidebar_label: ${componentName}\n`;
   content += `---\n`;
 
@@ -61,6 +63,12 @@ components.forEach(component => {
     content += `:::\n`;
   }
 
+  if (component.caution) {
+    content += `:::caution\n`;
+    content += `${component.caution}\n`;
+    content += `:::\n`;
+  }
+
   /* Images */
   content += `<div style={{display: 'flex', flexDirection: 'row', overflowX: 'auto', maxHeight: '500px', alignItems: 'center'}}>`;
   component.images?.forEach(image => {

src/components/textField/textField.api.json

@@ -0,0 +1,9 @@
+{
+  "name": "TextField",
+  "category": "form",
+  "description": "A customizable TextField component with validation features",
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/componentScreens/TextFieldScreen/InputsScreen.js",
+  "caution": "Please consider moving to our new TextField implementation and use Incubator.TextField instead",
+  "images": [],
+  "props": []
+}

src/components/toast/toast.api.json

@@ -0,0 +1,9 @@
+{
+  "name": "Toast",
+  "category": "overlays",
+  "description": "A customizable Toast component",
+  "example": "https://github.com/wix/react-native-ui-lib/blob/master/demo/src/screens/componentScreens/ToastsScreen.js",
+  "caution": "Please consider moving to our new Toast implementation and use Incubator.Toast instead",
+  "images": [],
+  "props": []
+}