---
# System prepended metadata

title: Rewrite

---

Comments & what we're working on:
* Getting Solid better understood is the first priority
    * Not beginner friendly at the moment
    * Hard to know where to begin
    * Trouble shooting is difficult because of the trouble navigating through docs / topics
* Complicated concepts tend to be only briefly touched on
    * Need to elaborate on some points more
    * Need to abstract out more complicated concepts to their own sections
        * SSR
        * Reactivity
        * Signals
        * etc
* Information is present in docs already
* Needs to be easier to find
    * Better titles for nav
    * Better layout

Would like to add??
* Search functionality will need to be implemented
* Ideally get a CLI for quick start
    * Easier to set up projects
    * Easier to adopt for beginners
    * Makes documentation easier - we don't have to document every template / setup option we could just refer to CLI
    * Community member or Solid member to try building??


## Introduction
* Overview 
* Core Principles
* Quick Start Tutorial
* Installation & Setup
* FAQ

## Essentials --> Learning orientated
* Understanding JSX Syntax
* Introduction to Reactivity
* Components and Props
    * Writing your first component
        * Defining components
        * Component Structure
        * How Components Differ in Solid 
    * Importing / exports
    * What are Props
    * How to use props to pass data to components
* Bindings
    * Class
    * Style
    * inline
* Signals
    * What are Signals
    * createSignal
    * Derived Signals
        * Wrapping signals in functions
* Managing Side Effects
    * What are side effects
    * When and how to use createEffect
    * Dealing with Async operations
        * How to handle in things like API calls
    * Cleanup functionality
        * How to use cleanup function to handle necessary cleanup operations
* Computed Values
    * What are computed values
    * When and how to use createMemo
    * Computed values vs signals
* Conditional Rendering
    * Control Flow
    * Show
    * Dynamic
* List Rendering
    * For
    * Index
* Event Handling

## Tutorials
* Build a To Do App

## Guides --> task orientated
* Styling your Components
    * CSS Preprocessors
        * SASS
        * LESS
    * CSS-in-JS
        * UnoCSS
    * CSS Modules
    * CSS Framework Integration
        * TailwindCSS
        * WindiCSS
* Routing & Navigation
    * Basics of Routing
        * Switch & Match
    * Solid Router
* Fetching Data
    * createResource
    * Async
* State Management
    * Reactive Data Handling
    * Using Stores for State Management
    * Managing Side Effects
* Deploying your App
    * Deployment Options
        * Vercel
        * Netlify
        * Firebase
        * Cloudflare
        * Railway
* TypeScript for Solid
* Testing
    * Writing Unit Tests
    * Integration Testing

## Best Practices --> Understanding orientated (*later*)
* Accessiblity
* Performance
* Error Handling and Debugging
* Linting

## Additional Resources
* Solid vs. (*later*)
    * Comparison with other frameworks
* Ecosystem
    * Include community plugins, integrations, tools, etc
* Contribution Guide
* Community and Support
    * Where to go for help
    * Dicsussion forums, socials

## API --> All reference (information based)
* Once core docs are done focus will be redirected to here


## Comments
- Broken link management
    - Keep resources within Solid community to avoid broken links
    - Make sure to provide proper recognition 
- Introduce references from community members
    - Blogs, videos, etc in relevant sections
    - Maintained by community members
        - Offer a place for new OSS individuals to contribute
- Docs roles
    - how to split up 
- Live doc for contributions
- GitHub project for docs