Skip to content

Commit fc0cdfd

Browse files
authored
Merge pull request #6 from oslabs-beta/LK/Readme
Lk/readme
2 parents aeccbf3 + 349b13b commit fc0cdfd

File tree

2 files changed

+36
-31
lines changed

2 files changed

+36
-31
lines changed

README.md

Lines changed: 36 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,45 @@
1-
# react-labyrinth README
1+
# React Labyrinth
22

3-
This is the README for your extension "react-labyrinth". After writing up a brief description, we recommend including the following sections.
3+
![React Labyrinth Logo](https://github.com/oslabs-beta/React-Labyrinth/blob/LK/Readme/media/reactLabyrinth.png)
44

5-
## Features
5+
# __Table of Contents__
6+
1. [Overview](#overview)
7+
2. [Features](#features)
8+
3. [Installation](#installation)
9+
4. [Getting Started](#getting-started)
10+
5. [Known Issues](#known-issues)
11+
6. [Release Notes](#release-notes)
12+
7. [Meet Our Team](#meet-our-team)
13+
8. [License](#license)
14+
15+
*work in progress as of 11/13/23*
16+
## Overview
17+
React Server Components are components that run exclusively on the server, allowing the components to do things such as making their own database queries inside of the component, rather than having to make a request to the backend first. These components are different from the components we usually write in React, which under this new paradigm are refered to as Client Components. But the problem is it's not always clear which Client Components could instead be Server Components which would save space on the bundle size and decrease TTI(time to interactive) for the client.
618

7-
Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.
19+
We want to create a visualization tool to help developers know where these changes could be implemented and how much time and space their application would save from these potential changes. _(Make sure to "trust our extension" in order to see the bundle size and TTI metrics)_
820

9-
For example if there is an image subfolder under your extension project workspace:
21+
## Features
22+
23+
Our tool will
24+
* Show which components are currently considered Client Components or Server Components
25+
* Show if a Client Component has the potential to be a Server Component.
26+
* Display the change in Bundle Size and TTI for the web application
1027

1128
\!\[feature X\]\(images/feature-x.png\)
1229

1330
> Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow.
1431
15-
## Requirements
32+
## Installation
1633

17-
If you have any requirements or dependencies, add a section describing those and how to install and configure them.
34+
Our visualization tool can be downloaded as an extension in the VS Code Editor. Search for React Labrynth and click "install".
1835

19-
## Extension Settings
36+
## Getting Started
2037

21-
Include if your extension adds any VS Code settings through the `contributes.configuration` extension point.
38+
Select the root file for your React App to load the tree.
2239

23-
For example:
40+
Any components that are Client Components will have a blue background and Server Components will have an orange background.
2441

25-
This extension contributes the following settings:
42+
If the component has the potential to be a Server Component, there will be an orange dotted outline surrounding the component node on the tree.
2643

2744
* `myExtension.enable`: Enable/disable this extension.
2845
* `myExtension.thing`: Set to `blah` to do something.
@@ -39,27 +56,15 @@ Users appreciate release notes as you update your extension.
3956

4057
Initial release of ...
4158

42-
### 1.0.1
43-
44-
Fixed issue #.
45-
46-
### 1.1.0
47-
48-
Added features X, Y, and Z.
49-
50-
---
51-
52-
## Working with Markdown
53-
54-
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
59+
## Meet Our Team
5560

56-
* Split the editor (`Cmd+\` on macOS or `Ctrl+\` on Windows and Linux)
57-
* Toggle preview (`Shift+Cmd+V` on macOS or `Shift+Ctrl+V` on Windows and Linux)
58-
* Press `Ctrl+Space` (Windows, Linux, macOS) to see a list of Markdown snippets
61+
* Ashley Luu
62+
* Christina Raether
63+
* Francisco Lopez
64+
* Johnny Arroyo
65+
* Louis Kuczykowski
5966

60-
## For more information
6167

62-
* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
63-
* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)
68+
## License
6469

65-
**Enjoy!**
70+
React Labrynth is developed under the [MIT license](https://en.wikipedia.org/wiki/MIT_License)

media/reactLabyrinth.png

848 KB
Loading

0 commit comments

Comments
 (0)