hulyak / a-to-z-coding-resources Goto Github PK

For build as espected in repository documentation with node 17.x or or higher (I have 18.5) just put this code fragment in package.json to build successfully.

SET NODE_OPTIONS=--openssl-legacy-provider

It should look as follows.

"start": "SET NODE_OPTIONS=--openssl-legacy-provider && docusaurus start",

This solves problems with "digital envelope routines" and prevents the error in title.

opensslErrorStack: [ 'error:03000086:digital envelope routines::initialization error' ],
library: 'digital envelope routines',
reason: 'unsupported',
code: 'ERR_OSSL_EVP_UNSUPPORTED'

Follow these steps to add a new resource to the page.

• Go to the docs folder and look at the resources.
• All you need is to add a unique new resource to any of the markdown files. You only need to add one resource for the Pull Request.
• Go to the end of the page and add a new resource.
• Image of the resource is not necessary, if you want to add the image of the website, you can first load the image on Dev.to and paste the link from there.
• You can add a short description after the heading. For the heading use ### for Heading level 3 and make sure it looks good.

If you need help writing markdown files, you can check out this website.

You can checkout this example:

### 1.[Reacti Flux](https://discord.com/invite/reactiflux)

Reacti Flux is the largest community of React developers (110,000+)!

Run the Project

Install dependencies and start the project in localhost 3000.

npm install
npm start

Make sure the page loads with no errors and you have added a new resource.

Stage, Commit, and Push Your Changes

Next, you want to stage, commit, and push your changes to your fork. Staging means saving your changes so they are ready to be added to your branch.

git add .
git commit -m "type your commit message"
git push

git push adds the changes on your computer to your GitHub repository.

Create a Pull Request

Navigate back to the original repo from which you forked, and you will see a prompt to open a new Pull Request from the branch you just pushed to.

Click Compare & pull request, add a description describing the changes you made.

To submit your pull request, click the green 'Create pull request' button.

Well done, you have made your first pull request! 🎉🎉🎉

Creating A New Resource Page and Adding New Resource

If you cannot find a new resource to add, you can just create a new page and a different category. It can be related to frontend, backend, cloud, blockchain, or mobile development. It can be whatever you want.

For that, create a new markdown file for a new category and add the resource there.

• create the file name as <category>-<number>.md and add the resource to the file. For example, you can the file as free-websites-1.md. Then, go to sidebars.js file in the root of the project and add the file name to the list.

module.exports = {
  someSidebar: {
    resources: [
      'free-websites-1',
      'free-media-3',
      'react-5',
      'css-2',
      // 'markdown-features',
      'javascript-4',
      'nextjs-6',
      'job-hunt-8',
      'career-9',
      'computer-science-7',
      // add the new file name
    ],
  },
}

• MDX file starts with YAML front matter block declared as triple-dashed lines. Declare the title property.

---
title: Free Images/Videos
---

• After the title, add your resource similar to this:

### 1.[Reacti Flux](https://discord.com/invite/reactiflux)

Reacti Flux is the largest community of React developers (110,000+)!

Run the project

npm install
npm start

Make sure the page loads with no errors and you have added a new resource.

Stage, Commit, and Push Your Changes

Next, you want to stage, commit, and push your changes to your fork. Staging means saving your changes so they are ready to be added to your branch.

git add .

git commit -m "type your commit message"

git push

git push adds the changes on your computer to your GitHub repository.

Create a Pull Request

Navigate back to the original repo from which you forked, and you will see a prompt to open a new Pull Request from the branch you just pushed to.

Click Compare & pull request, add a description describing the changes you made.

To submit your pull request, click the green 'Create pull request' button.

Well done, you have made your first pull request! 🎉🎉🎉