Skip to content

Commit d8438f8

Browse files
committed
fix code blocks after formatting
1 parent c6a0634 commit d8438f8

File tree

192 files changed

+1306
-2540
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

192 files changed

+1306
-2540
lines changed

.prettierrc

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,14 @@
33
"tabWidth": 2,
44
"semi": true,
55
"singleQuote": false,
6-
"useTabs": true
6+
"useTabs": true,
7+
"overrides": [
8+
{
9+
"files": "*.mdx",
10+
"options": {
11+
"proseWrap": "never",
12+
"parser": "mdx"
13+
}
14+
}
15+
]
716
}

CONTRIBUTING.md

Lines changed: 15 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -2,27 +2,21 @@
22

33
Thank you for helping us make this project great and being a part of the Solid community!
44

5-
We welcome contributions from anyone, regardless of your skill level.
6-
We are happy to help with guidance on PRs, technical writing, and turning features into realities.
5+
We welcome contributions from anyone, regardless of your skill level. We are happy to help with guidance on PRs, technical writing, and turning features into realities.
76

8-
> **New to contributing?**
9-
> Take a look at [this GitHub guide](https://docs.github.com/en/get-started/start-your-journey/hello-world) to learn how to use Git and GitHub to contribute to open-source.
7+
> **New to contributing?** Take a look at [this GitHub guide](https://docs.github.com/en/get-started/start-your-journey/hello-world) to learn how to use Git and GitHub to contribute to open-source.
108
119
If you're new to Solid, we ask that you check out our [Writing Guide](https://github.com/solidjs/solid-docs-next/blob/main/WRITING.md).
1210

1311
## Types of contributions
1412

1513
There are many ways to contribute to the Solid's documentation!
1614

17-
The Solid Docs website is built on Solid!
18-
Maintaining it requires not only written content and Solid code maintenance, but it also needs to address accessibility (a11y), CSS, UI, and UX concerns.
19-
We also aim to make our documentation available in several languages, so we need help translating the entire site.
15+
The Solid Docs website is built on Solid! Maintaining it requires not only written content and Solid code maintenance, but it also needs to address accessibility (a11y), CSS, UI, and UX concerns. We also aim to make our documentation available in several languages, so we need help translating the entire site.
2016

2117
You can help out by leaving review comments on [PRs](https://github.com/solidjs/solid-docs-next/pulls) and adding ideas in existing GitHub [issues ](https://github.com/solidjs/solid-docs-next/issues) and [discussions](https://github.com/solidjs/solid-docs-next/discussions).
2218

23-
Every PR, especially translation PRs, will need reviewers.
24-
Reviewing PRs and leaving comments, suggestions, or even saying "Looks good!" can be a great way to get started on contributing alongside our Docs team.
25-
It's also a great way to learn more about Solid!
19+
Every PR, especially translation PRs, will need reviewers. Reviewing PRs and leaving comments, suggestions, or even saying "Looks good!" can be a great way to get started on contributing alongside our Docs team. It's also a great way to learn more about Solid!
2620

2721
We encourage you to:
2822

@@ -71,8 +65,7 @@ We use labels as a way to organize and categorize our issues. Here are some comm
7165

7266
## Start a discussion
7367

74-
Discussions are a place within this repository where we can have open-ended conversations.
75-
It's the perfect place for Q&A, sharing ideas, community engagement, and connecting with other members.
68+
Discussions are a place within this repository where we can have open-ended conversations. It's the perfect place for Q&A, sharing ideas, community engagement, and connecting with other members.
7669

7770
Feel free to start a [new discussion](https://github.com/solidjs/solid-docs-next/discussions) on any topic related to our docs!
7871

@@ -87,25 +80,22 @@ Feel free to start a [new discussion](https://github.com/solidjs/solid-docs-n
8780

8881
> If you've never submitted a pull request on GitHub before, check out [this overview on how to open a PR](https://opensource.guide/how-to-contribute/#opening-a-pull-request).
8982
90-
PRs are the heart of collaboration on GitHub.
91-
When you open a pull request, you are putting forward your suggested changes, inviting us to review it, and requesting for these changes to be merged into our main branch.
83+
PRs are the heart of collaboration on GitHub. When you open a pull request, you are putting forward your suggested changes, inviting us to review it, and requesting for these changes to be merged into our main branch.
9284

9385
Here's how to effectively contribute via a PR:
9486

9587
- **Understand the Scope**: Before creating a PR, ensure it addresses an existing issue. Remember to link your PR to the issue it solves for easy tracking and understanding.
9688
- **Singular Focus**: Each PR should address a single issue or enhancement. Want to propose a larger change? Reach out to us on [Discord](https://discord.com/invite/solidjs) and let's discuss the best way forward!
9789
- **Drafts for Early Feedback**: If you're seeking early feedback but aren't quite finished with your changes, consider creating a draft PR. Simply prefix your PR title with `**[Draft]**`. This way, you can get input on your work-in-progress.
98-
- **Quality over Quantity**: Strive for the quality of your contribution rather than the quantity. A well-thought-out, cleanly coded, and thoroughly tested PR is much more valuable than a hastily done large one.
99-
Contributing via PRs not only enhances the project, but also allows you to be a part of the active community, sharing ideas, learning, and growing with the project.
90+
- **Quality over Quantity**: Strive for the quality of your contribution rather than the quantity. A well-thought-out, cleanly coded, and thoroughly tested PR is much more valuable than a hastily done large one. Contributing via PRs not only enhances the project, but also allows you to be a part of the active community, sharing ideas, learning, and growing with the project.
10091

10192
> Existing PRs and Issues need reviewing, triaging, and feedback, too! You can make valuable contributions by commenting, suggesting, testing, researching, brainstorming and generally helping in all areas!
10293
10394
### Writing a PR
10495

10596
> Need help making a PR? [Join us on Discord](https://discord.com/invite/solidjs), we'll be more than happy to help you out!
10697
107-
Contributions to the documentation site are made by editing the docs repository.
108-
You can do this directly on GitHub.com or by creating a copy of the repository locally, making your changes there, and contributing back to our repository.
98+
Contributions to the documentation site are made by editing the docs repository. You can do this directly on GitHub.com or by creating a copy of the repository locally, making your changes there, and contributing back to our repository.
10999

110100
#### Examples of helpful PRs
111101

@@ -115,11 +105,9 @@ You can do this directly on GitHub.com or by creating a copy of the repository l
115105

116106
### Edit this page via GitHub
117107

118-
Every page on [docs.solidjs.com](https://docs.solidjs.com/) has an **Edit this page** link at the bottom.
119-
You can click on that button to edit the source code for that page in **GitHub**.
108+
Every page on [docs.solidjs.com](https://docs.solidjs.com/) has an **Edit this page** link at the bottom. You can click on that button to edit the source code for that page in **GitHub**.
120109

121-
After you make your changes, click **Commit changes**.
122-
This will automatically create a [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) of the docs in your GitHub account with the changes.
110+
After you make your changes, click **Commit changes**. This will automatically create a [fork](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/about-forks) of the docs in your GitHub account with the changes.
123111

124112
Once you have committed your edits within your fork, follow the prompts to create a **pull request** and submit your changes for review.
125113

@@ -153,13 +141,11 @@ To translate a new entry to an existing language, go to `src/routes/{locale}` an
153141

154142
Once you have made your changes using your preferred method, you're ready to create a 'pull request'.
155143

156-
This will let the Solid docs team know you have some changes you would like to propose.
157-
At this point, we can give you feedback and possibly request changes.
144+
This will let the Solid docs team know you have some changes you would like to propose. At this point, we can give you feedback and possibly request changes.
158145

159146
[Read more about making a pull request in GitHub's docs.](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project#making-a-pull-request)
160147

161-
Please include a clear title.
162-
The description will have some pre-filled questions that we would like you to answer.
148+
Please include a clear title. The description will have some pre-filled questions that we would like you to answer.
163149

164150
Every pull request generates a preview of the site, including your proposed changes, using **Netlify** for anyone to see.
165151

@@ -171,21 +157,17 @@ The docs site will be automatically updated whenever pull requests are merged.
171157

172158
### Forks
173159

174-
On GitHub, you will need a 'fork' of this repository to work on.
175-
This is your own copy of the code base where you can make changes. You can read more about forks in [GitHub's documentation](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project).
160+
On GitHub, you will need a 'fork' of this repository to work on. This is your own copy of the code base where you can make changes. You can read more about forks in [GitHub's documentation](https://docs.github.com/en/get-started/exploring-projects-on-github/contributing-to-a-project).
176161

177-
Not sure how to get started with GitHub, forks, pull requests, or want a refresher?
178-
You can watch this video series: [How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github).
162+
Not sure how to get started with GitHub, forks, pull requests, or want a refresher? You can watch this video series: [How to Contribute to an Open Source Project on GitHub](https://egghead.io/courses/how-to-contribute-to-an-open-source-project-on-github).
179163

180164
#### Creating a fork
181165

182166
To create your copy, click the `Fork` button at the top right of any page in this repository.
183167

184168
#### Maintaining a fork
185169

186-
When you first create your fork, it will be an exact copy of this repository.
187-
Over time, our docs will change as they are updated, but your fork won’t automatically stay up-to-date.
188-
Here are some ways to keep your fork in sync with this repo:
170+
When you first create your fork, it will be an exact copy of this repository. Over time, our docs will change as they are updated, but your fork won’t automatically stay up-to-date. Here are some ways to keep your fork in sync with this repo:
189171

190172
##### Update through GitHub UI
191173

README.md

Lines changed: 15 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -2,75 +2,49 @@
22

33
Welcome to Solid's documentation!
44

5-
This is the repo for [docs.solidjs.com](https://docs.solidjs.com/). This repo
6-
contains all the source code that we use to build our docs.
5+
This is the repo for [docs.solidjs.com](https://docs.solidjs.com/). This repo contains all the source code that we use to build our docs.
76

8-
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/solidjs/solid-docs-next)
9-
[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/github/solidjs/solid-docs-next/)
10-
[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/solidjs/solid-docs-next)
7+
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/solidjs/solid-docs-next) [![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/github/solidjs/solid-docs-next/) [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/solidjs/solid-docs-next)
118

129
## What is Solid?
1310

14-
Solid is a JavaScript framework used for building high-performance
15-
user-interfaces. Using a reactive approach and component-based architecture, we
16-
want to empower developers in creating efficient and scalable web applications.
11+
Solid is a JavaScript framework used for building high-performance user-interfaces. Using a reactive approach and component-based architecture, we want to empower developers in creating efficient and scalable web applications.
1712

1813
## Thank you for being here!
1914

20-
You can help make our docs better for the community! Your feedback is welcomed.
21-
In addition, any editing, translating, designing, and developing skills are
22-
welcomed. We are grateful to welcome you into our community!
15+
You can help make our docs better for the community! Your feedback is welcomed. In addition, any editing, translating, designing, and developing skills are welcomed. We are grateful to welcome you into our community!
2316

24-
If you want to see how you can contribute, check out our
25-
[How You Can Help](#how-you-can-help) section.
17+
If you want to see how you can contribute, check out our [How You Can Help](#how-you-can-help) section.
2618

2719
## Chat with us
2820

29-
You can learn more about Solid, get support, and meet other devs and
30-
contributors in our [Discord community](https://discord.com/invite/solidjs).
21+
You can learn more about Solid, get support, and meet other devs and contributors in our [Discord community](https://discord.com/invite/solidjs).
3122

3223
## Raise an issue
3324

34-
Have you noticed something is missing, confusing, or is wrong in our
35-
documentation?
25+
Have you noticed something is missing, confusing, or is wrong in our documentation?
3626

37-
Check to see if it has
38-
[already been mentioned ](https://github.com/solidjs/solid-docs-next/issues)
39-
and, if not,
40-
[create an issue](https://github.com/solidjs/solid-docs-next/issues/new/choose)
41-
to bring it to our attention!
27+
Check to see if it has [already been mentioned ](https://github.com/solidjs/solid-docs-next/issues) and, if not, [create an issue](https://github.com/solidjs/solid-docs-next/issues/new/choose) to bring it to our attention!
4228

4329
## Share an idea
4430

45-
Do you think something could be better? Have an idea you feel could make the
46-
docs better?
31+
Do you think something could be better? Have an idea you feel could make the docs better?
4732

48-
Discussion threads are where you can offer feedback on things that might not be
49-
problems that need addressing, but are ideas to be explored.
33+
Discussion threads are where you can offer feedback on things that might not be problems that need addressing, but are ideas to be explored.
5034

51-
Join us in the
52-
[Discussions section](https://github.com/solidjs/solid-docs-next/discussions/280)
53-
where we can brainstorm these ideas, ask questions, and share goals!
35+
Join us in the [Discussions section](https://github.com/solidjs/solid-docs-next/discussions/280) where we can brainstorm these ideas, ask questions, and share goals!
5436

5537
## Suggest a fix or contribute
5638

5739
Have you found a typo, broken link, or another item with an obvious quick fix?
5840

59-
If you can see what the problem is, and you know how to fix it, you can make a
60-
PR (pull request) with the change and contribute to the docs repo yourself.
41+
If you can see what the problem is, and you know how to fix it, you can make a PR (pull request) with the change and contribute to the docs repo yourself.
6142

62-
If you're looking to make a larger contribution, please see our
63-
[CONTRIBUTING.md](https://github.com/solidjs/solid-docs-next/blob/main/CONTRIBUTING.md)
64-
first!
43+
If you're looking to make a larger contribution, please see our [CONTRIBUTING.md](https://github.com/solidjs/solid-docs-next/blob/main/CONTRIBUTING.md) first!
6544

6645
## Running the Site Locally
6746

68-
At the moment, we recommend running the site locally through either
69-
[CodeSandbox](https://codesandbox.io/p/github/solidjs/solid-docs-next/),
70-
[Gitpod](https://gitpod.io/#https://github.com/solidjs/solid-docs-next), or
71-
[StackBlitz](https://stackblitz.com/github/solidjs/solid-docs-next). These are
72-
the quickest and easiest way to browse and edit the project files and run the
73-
site locally.
47+
At the moment, we recommend running the site locally through either [CodeSandbox](https://codesandbox.io/p/github/solidjs/solid-docs-next/), [Gitpod](https://gitpod.io/#https://github.com/solidjs/solid-docs-next), or [StackBlitz](https://stackblitz.com/github/solidjs/solid-docs-next). These are the quickest and easiest way to browse and edit the project files and run the site locally.
7448

7549
The app uses [pnpm](https://pnpm.io) as the package manager and it runs on Node.js `v18+`.
7650

@@ -90,7 +64,6 @@ This will start your the app at [localhost:3000](http://localhost:3000) or the n
9064

9165
### Collections and virtual modules
9266

93-
The builds an [Astro](https://docs.astro.build/en/guides/content-collections/) inspired collection navigation, it will bring all routes and generate a couple of files at `/.solid`.
94-
These files are exposed to your app via [Vite virtual modules](https://vitejs.dev/guide/api-plugin#virtual-modules-convention). This task is perform via our `sync` script (`pnpm sync`), ran before every build.
67+
The builds an [Astro](https://docs.astro.build/en/guides/content-collections/) inspired collection navigation, it will bring all routes and generate a couple of files at `/.solid`. These files are exposed to your app via [Vite virtual modules](https://vitejs.dev/guide/api-plugin#virtual-modules-convention). This task is perform via our `sync` script (`pnpm sync`), ran before every build.
9568

9669
If changes are made to the navigation (new entry, or repositioning entry), it is necessary to restart the server for changes to take effect.

0 commit comments

Comments
 (0)