Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Adding dynamic banner and new contributor notes
- Loading branch information
David Di Biase
authored and
David Di Biase
committed
Jun 10, 2022
1 parent
17763fa
commit 131aa89
Showing
2 changed files
with
104 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,84 @@ | ||
# Contributing to SolidJS | ||
|
||
Thank you for investing your time in contributing to our project! ✨. | ||
|
||
Read our [Code of Conduct](https://github.com/solidjs/solid/blob/main/CODE_OF_CONDUCT.md) to keep our community approachable and respectable. Solid accepts a number of contributions from the broader community. More hands indeed make lighter work. We're however selective of the types of contributions we receive. | ||
|
||
This usually involves vetting code quality, current focus, alignment with team philosophies etc. It's typically a good idea to submit a proposal for a change before spending time implementing it. This is to ensure that your efforts align with the current needs or more practically that work isn't completed by multiple contributors. | ||
|
||
Note: If you would like your project listed here please submit a PR or contact a core/ecosystem member on Discord. | ||
|
||
## Team Structure & Organization | ||
|
||
There are a lot of opportunities to get involved. We organize Solid community efforts via Discord and typically onboard dedicated contributors into focused teams: | ||
|
||
- Docs (headed by @Jutanium) | ||
- Infrastructure (headed by @davedbase) | ||
- Advocacy (headed by @hindsight) | ||
- Translators (headed by @davedbase) | ||
|
||
Most team members are part of the Ecosystem Team or Core Team. Entry into these groups is selected by Core Members only. We do not accept applications or request for entry. Selections are made ad-hoc according to internal needs. Selections are typically announced at Community Meetings which occur quarterly. | ||
|
||
## Meetings and Schedules | ||
|
||
SolidJS team members organize via Discord chat and audio channels. Channels exist to manage these conversations and threads within channels are used to focus on specific topics. A number of meetings occur weekly between each group howevere there is no set cadence or recurring schedule. Typically attendance for team members is requested to maintain membership, however we respect and recognize OSS contributions are typically ad hoc and as can be given by our members and generous donors. | ||
|
||
## Official Opportunities | ||
|
||
As a growing community, Solid has an on-going need for developers, writers, designers and general though leaders. The following is a list of openings and tasks that Core attempts to maintain often. | ||
|
||
### Docs Team | ||
|
||
- General support | ||
- Improve and adapt documentation to future Solid versions | ||
- Support docs team with new section writing, tutorial maintenance etc. | ||
- Translate documentation or ensure documentation translations are aligned with English formats | ||
- Solid Start 1.0 API | ||
- Learn and implement basic API documentation | ||
- Organize and translate incoming tutorials and documentation sets | ||
|
||
### Infrastructure Team | ||
|
||
- Solid Site | ||
- Help maintain the current Solid website by implementing bugs, testing and reporting issues | ||
- Port the current website from being an SPA to Solid Start | ||
- Website redevelopment project for 2.0 | ||
- Solid Service API | ||
- Help implement our API service that powers solid REPL | ||
- Test, validate and implement security and bug fixes | ||
- Add new missing features | ||
- Develop new Solid Docs platform and website | ||
- Help coordinate creating MDX components | ||
- Developer infrastructure for delivering future community documentation platform | ||
- Solidex (our ecosystem directory) | ||
- How maintain a list of ecosystem projects and resources (articles, podcasts etc.) | ||
- Vet incoming PR from submissions and merge + deploy updated the directory | ||
- Improve workflow and systems for managing Solidex | ||
- Implement an API (via Solid Service API) to search and filter resources | ||
- Solid Dev Tools | ||
- We're actively looking for individuals to prototype and experiment on a set of developer tools. | ||
|
||
### Solid Start Team | ||
|
||
Solid Start is our new meta framework that focuses on enhancing Solid's DX story and general usability. Similar to SvelteKit, Next and other meta frameworks, this project is considered a primary core supported effort. Solid Start is approaching it's beta release and we're looking for developers to test, validate and build on top of it. Join the #solid-start channel on Discord or the [solid-start](https://github.com/solidjs/solid-start) to learn more. | ||
|
||
## Ecosystem Opportunities | ||
|
||
SolidJS core members maintain a separate project called [SolidJS Community](https://github.com/solidjs-community). This is a large and lush ecosystem community project that encompasses a number of critical core tooling such as Solid Primitives, Solid Aria (similar to React Aria) etc. | ||
|
||
The following are projects looking for leaders or support: | ||
|
||
- **Solid Aria** (lead by @fabien-ml): A port of React Aria | ||
- **Solid Examples** (lead by @foolswisdom): A list of examples, patterns and app implementations. | ||
- **Solid Codemod** (lead by @trivikr): Convert React or other libraries to Solid automatically. | ||
- **Solid Snippets** (lead by @thetarnav): VSCode snippet libraru | ||
- **Solid DSL** (lead by @davedbase): A project to explore enhancing JSX or other DSL options. | ||
- **Solid Primitives** (lead by @davedbase): A large primitives (hooks) library. | ||
|
||
Contributing to ecosystem projects is just as important as contributing to Solid core projects. As Solid grows a lush, well supported and high-quality set of packages and learning materials will benefit it's users and future viability. | ||
|
||
## Where do I start? | ||
|
||
If you haven't found any interesting information on this page then we encourage you to start hacking at a Solid related utility or package that does. Building useful tools for fellow OSS ecosystem and Solid users enhances the whole platform. | ||
|
||
We can't wait to see what you build! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters