Docusaurus: 🌟Help us feature more Docusaurus v1 users!

[yangshun]

Tip: This is a beginner level Docusaurus task that requires almost no coding and is more targeted at newcomers to the project and Open Source.

📚 Documentation

We want to feature more Docusaurus users and we need your help!

Docusaurus has a users page where we showcase projects using Docusaurus. This has the benefits of giving projects recognition and also lets the community and new users reference the creative ways of using Docusaurus. For example, Babel implemented the "copy code" button which we copied into our code, Reason has a full-width doc page and Prettier has a playground.

Here's a list of projects that we want to feature, in no particular order.

• [x] https://github.com/reduxjs/react-redux/ (@wgao19)
• [x] https://github.com/jaredpalmer/formik (@shahednasser)
• [x] https://github.com/node-serialport/node-serialport (@mikeattara)
• [x] https://github.com/facebook/react-360 (@sunitasen)
• [x] https://github.com/callstack/haul (@ellereeeee)
• [x] https://github.com/19majkel94/type-graphql (@19majkel94)
• [x] https://github.com/zamotany/react-slate (@andrewShillito)
• [x] https://github.com/hemerajs/hemera (@alexperez)
• [x] https://github.com/Cretezy/Noderize (@Rajekevin)
• [x] https://github.com/react-native-sensors/react-native-sensors (@mikeattara)
• [x] https://github.com/Khan/KaTeX (@haoqiang)
• [x] https://github.com/PaulLeCam/react-leaflet (@zakariaharti)
• [x] https://github.com/reduxjs/redux (@YifanM)
• [x] https://github.com/scalameta/scalafmt (@ahtee)
• [x] https://github.com/apache/pulsar (@NishealJ)
• [x] https://github.com/boyney123/mockit (@NishealJ)
• [x] https://testing-library.com/ (@hongarc)
• [x] https://github.com/qiu8310/minapp (@qiu8310 + @NishealJ)

The process of adding users goes like this:

1. Comment below with the project you're interested in helping and make sure it's not already claimed.
2. Check if the project has a logo. If it doesn't have a logo, we could ask them to create one. If not, then we can't feature it as we don't have a way to feature projects without logos at the moment. Sorry about that.
3. Make an issue on the GitHub project, asking about featuring their project on Docusaurus (most people would be okay with that).
4. Get a reasonable-sized version of their logo (SVG preferred) and add it to website-1.x/static/img/users/<project-name-in-lower-snake-case>.{svg/png/jpg} not exceeding 512x512. Look into their website directory or project directory for the logo image file. Try to compress the logo first if possible using Photoshop or some online tools.
5. Modify website-1.x/data/users.js and add the project into the JS file, sorted alphabetically by caption:

{
  caption: 'The Project Name',
  image: '/path/to/image',
  infoLink: 'www.example.com', // Website. Can be GitHub repo URL if website doesn't exist
  fbOpenSource: false,
  pinned: false,
},

1. Run the Docusaurus website locally and see that the users page loads fine and shows the new user!
2. Run yarn lint and yarn prettier before submitting the PR.
3. Use the PR title - docs: showcase user <project name>.
4. In the PR summary, add a link to the PR where you've asked the project for permissions to include their logo
5. Submit your PR!

Have you read the Contributing Guidelines on issues?

Yes

[shahednasser]

I'm interested in working on Formik

[yangshun]

@shahednasser Thanks, have updated the description with your name.

[Rajekevin]

Hello @yangshun ,
I am interested in working on Noderize

[yangshun]

@Rajekevin Thanks, have updated the description with your name.

[sunitasen]

@yangshun I am interested in react-360

[yangshun]

@sunitasen It's yours! React-360 doesn't need permission because it's by FB. Go ahead and create the PR!

[andrewShillito]

@yangshun Hello. I'm interested in working on react-slate.

[yangshun]

@andrewShillito Go ahead. Thank you! It might be an issue because they don't have a logo. If that's the case, pick some other project.

[andrewShillito]

@yangshun Ok thank you! They have a couple of assets here and here that I was thinking might work. I'll check in with them, make a PR and if it works out cool and if not I'll select another project.

[andrewShillito]

@yangshun I'd be happy to do some more (starting with almond) unless you would prefer to reserve these for other newcomers to get involved with the project.

[yangshun]

@andrewShillito By all means! Go ahead! Thank you!

[alexperez]

Hello @yangshun
I’m interested in working on hemera.

[yangshun]

@alexperez It's yours!

[wgao19]

Hey @yangshun can I pick up React-Redux?

[yangshun]

@wgao19 definitely! I guess you don't need to ask for approval from React-Redux since you work on it 😉 Feel free to send us a PR anytime!

Please set pinned to true 😄

[ellereeeee]

Hello @yangshun ,

Can I please work on Haul?

[ymschaap]

@yangshun I made this form for Babel. It allows Docusaurus users to just fill out a form (instead of a fork, change file, add image, test, commit, PR), which will create a valid PR like this using a bot. Interested if I make the same feature available for Docusaurus?

[arijitthehacker]

Hi, I'm interested in working on express-validator.

[JoelMarcey]

@ymschaap Hi. When I click on the link to the form, it shows a security warning. Should it be http instead of https?

[JoelMarcey]

Hi, I'm interested in working on express-validator.

It's yours. 😄

[yangshun]

@ellereeeee it's yours!

I'll check in with you periodically so that we can keep the task updated with the progress.

[yangshun]

@arijitthehacker Go ahead!

[yangshun]

@ymschaap I'm unable to access the first link you provided, it leads to an error page. Based on what you are suggesting, it sounds awesome and we'd love to include it! Fill free to create a PR!

[ymschaap]

@yangshun @JoelMarcey my bad, that is my own localhost I linked to. The url is:

https://build.amsterdam/your-company/babel

[zakariaharti]

hello @yangshun
i'm interested in React-Leaflet

[yangshun]

@zakariaharti it's yours!

[ellereeeee]

@yangshun My pull request was merged.

docs: showcase user Haul #1130

[yangshun]

@ellereeeee Thanks, it has been updated

[mikeattara]

Hello @yangshun I would love to work on node-serialport

[yangshun]

@mikeattara It's yours!

[mikeattara]

@yangshun I would like to take up react-native-sensors
I am also working on adding a better logo for gulp

[mikeattara]

https://github.com/react-native-sensors/react-native-sensors/issues/195

[MichalLytek]

@yangshun
I've added myself 😄 (19majkel94/type-graphql)
https://github.com/facebook/Docusaurus/pull/1174

[yangshun]

@mikeattara go ahead, thank you! (EDIT: Sorry tagged wrong person previously)

[yangshun]

@19majkel94 That's amusing. Thank you too 🎉

[haoqiang]

Happy New Year ~

I'll take https://github.com/Khan/KaTeX then.

Interestingly there's an issue created by them already, but since I don't see KaTex in the user page, I'll just proceed. ref: https://github.com/KaTeX/KaTeX/issues/1753

[alchemist3301]

Hello @yangshun ,
I am interested in working on Detox :)

[yangshun]

@Alquimista3301 It's yours! Thanks!

[ahtee]

@yangshun
I'd like to take

• https://github.com/scalameta/scalafmt
  I'm assuming this would use the scalameta logo (.png)
  

[yangshun]

@ahtee Go ahead!

[ahtee]

@yangshun here's the approval. Ill go ahead and make the pr:
https://github.com/scalameta/scalafmt/issues/1373

[ahtee]

@yangshun in my pr #1250, some of the images arent showing up: is this just a netlify thing?

[ahtee]

thanks for covering that linting :)

[ahtee]

another addition could be https://microsoft.github.io/just/ 💯

[yangshun]

Thanks, updated with Just 😄

[co16353sidak]

@yangshun
Would like to work on adding twitchtv's twirp, I find that it is not taken by anyone at the moment and could be a good addition to the user's page.

[yangshun]

@co16353sidak It's yours!

[co16353sidak]

@yangshun I have received the green light to use the Twirp logo, although we cannot use the twitch logo as that would require some serious permissions being a complete company and all.
But we can use the Twirp logo which seems to me as sufficient for doing this.
What do you say?

P.S: Check the issue linked above for details and everything.

[co16353sidak]

Okay creating a PR for this.

[yangshun]

@co16353sidak Yes please go ahead. TIL that Twirp had a logo. Would be good for them to show it somewhere on their docs page.

Thanks for doing this!

[ahtee]

threads like this sometimes cascade into other pr's for other projects TIL!

[co16353sidak]

yeah @ahtee, added another issue 🎉 💯 but this rarely happens.

[co16353sidak]

@yangshun @ahtee would like to take up just as well, hopefully if I am allowed to take up another project. 🥇

[yangshun]

@co16353sidak Sorry for the late reply. By all means!

[NishealJ]

Hi @yangshun , I've taken up apache pulsar Thanks !

[hong4rc]

@yangshun I created some issue to ask permission add showcase.

Can I create PR to update image?(add logo to this project instead of they image)

[yangshun]

@Hongarc go ahead!

[yangshun]

Sorry I'm not understanding your question well. Let's follow the usual flow mentioned above. Feel free to message me on Discord, we can discuss there.

[hong4rc]

@yangshun Can I create PR others Docusaurus user, example https://openzeppelin.org/

[NishealJ]

Hi @arijitthehacker , can you please raise a PR for express-validator ?

[yangshun]

Closing this task and creating a part 2 issue to prevent noise to existing subscribers. Thank you for all your efforts thus far!