Merge pull request #8 from FlutterFlow/leighajarett/more-edits

adding stuff

Author: leighajarett

README.md

@@ -1,41 +1,40 @@
-# Website
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
+# Welcome to the FlutterFlow Documentation Repository!
+We're thrilled to have you here! Our documentation is a crucial resource for both new and existing users of FlutterFlow, and it grows and improves with contributions from our community. Whether you're fixing a typo, discussing a new topic, adding a troubleshooting guide, or sharing your experiences in a blog post, your contributions help everyone.
 
-### Installation Test
+Below you'll find guidelines on how you can contribute to different parts of the documentation.
 
-```
-$ yarn
-```
+### A little note on tooling
+Most of our documentation is written in markdown, which means it's super easy edit files. 
+You can choose to edit markdown directly in GitHub, or you can open up the entire reposiitory in StackBlitz.
 
-### Local Development
+Either way, you'll need to open up a pull request, and get an approval from at least one-code owner. 
 
-```
-$ yarn start
-```
+TO DO: add more details
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
+## 1. Editing Existing Pages
+To make edits to an existing page, you can use the "Edit this page" button that appears at the bottom of each page. 
+That brings you straight to the source of the page in GitHub.
 
-### Build
+## 2. Adding a New Docs Page
+To add a new docs page, simply create a new markdown page in a subdirectory within the docs directory. 
 
-```
-$ yarn build
-```
+To ensure that page shows up on the sidebar, add its path to the docsSidebar object inside the sidebars.ts file.
 
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+## 3. Adding a Troubleshooting Guide
+To add a new troubleshooting guide, simply create a new mardkown page in the docs/troubleshooting directory. 
 
-### Deployment
+## 4. Adding a Blog
+To add a new blog, simply create a new mardkown page in the blogs directory. 
 
-Using SSH:
+## 5. Generating the Changelog
+TO DO: auto-generating changelog
 
-```
-$ USE_SSH=true yarn deploy
-```
+### Ready to Contribute?
+Your contributions are vital to keeping FlutterFlow's documentation clear, up-to-date, and helpful. We look forward to seeing your pull requests and are excited to welcome you into our community of contributors!
 
-Not using SSH:
+### Top Contributors
 
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
+TO DO: *Perhaps we have some top contributors tabe that's autogenerated*? 
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+If you have any questions or need further guidance, don't hesitate to reach out to the documentation team. Happy documenting!

blog/2019-05-28-first-blog-post.md

@@ -1,17 +1,6 @@
-endi:
-  name: Endilie Yacop Sucipto
-  title: Maintainer of Docusaurus
-  url: https://github.com/endiliey
-  image_url: https://github.com/endiliey.png
-
-yangshun:
-  name: Yangshun Tay
-  title: Front End Engineer @ Facebook
-  url: https://github.com/yangshun
-  image_url: https://github.com/yangshun.png
-
-slorber:
-  name: Sébastien Lorber
-  title: Docusaurus maintainer
-  url: https://sebastienlorber.com
+#  Support team authors
+barry:
+  name: Barry
+  title: FlutterFlow Support Team
+  # url: https://sebastienlorber.com
   image_url: https://github.com/slorber.png

blog/2019-05-29-long-blog-post.md

@@ -0,0 +1,4 @@
+---
+title: FF Blog Overview
+sidebar_position: 1
+---

blog/2021-08-01-mdx-blog-post.mdx

@@ -25,7 +25,7 @@ import BranchIcon from '@site/static/icons/branch_New.png';
 ### FlutterFlow is a visual development environment that lets you build mobile, web, and desktop apps incredibly fast, without sacrificing quality or features. 
 
 <InfoCards>
-    <InfoCard icon={GearIcon} title="Before You Begin" description="Ensure you meet system requirements and grasp technical concepts for smooth building in FlutterFlow." />
+    <InfoCard icon={GearIcon} title="Before You Begin" description="Ensure you meet system requirements and grasp technical concepts for smooth building in FlutterFlow." pagePath="/intro/before-you-begin/setting-up-flutterflow" />
     <InfoCard icon={DocsIcon}  title="Explore FlutterFlow" description="Dive into the building blocks of the platform: projects, widgets, functions and more." />
     <InfoCard icon={DeviceIcon}  title="Start Building" description="Jump right into a quick start on how to build a simple app." />
     <InfoCard icon={CheckIcon}  title="Troubleshooting Guides" description=" Solutions and tips to solve common FlutterFlow development hurdles." />

blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg

@@ -1,5 +1,5 @@
 ---
-sidebar_position: 1
+title: App Architecture
 ---
 
 # App Development