sumn2u / sumn2u/learn-javascript

Translation needed for existing languages

Open
#301 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

good first issue translate help-wanted
Dominant language
HTML
Stars
1k
Forks
187
Avg merge
5d 5h
Merged PRs (30d)
1

Description

@mmunin has made changes on the original english version of the book (PR #300)

Visual Diff of Changes:

diff --git a/en/file-system/README.md b/en/file-system/README.md
index 82c985b..100cc9f 100644
--- a/en/file-system/README.md
+++ b/en/file-system/README.md
@@ -16,8 +16,8 @@ In this example, you are using the `fs.readFile` function to read data from the
 
 ```javascript
 const fs= require('fs');
-//async
-//non  blokcing i/0 thats why runs at last as ti takes moer time
+//asynchronous, non-blocking I/O that's why this runs last, as it takes more time
+
 fs.readFile('test.txt','utf8',(err,data) => {
     console.log(err,data)
 })
@@ -29,7 +29,7 @@ Here, you use fs.writeFile to write data to the 'test.txt' file asynchronously.
 
 ```javascript
 fs.writeFile("test.txt","mahima is good girl", () => {
-    console.log("This runs after writting in a file: written to file")
+    console.log("This runs after writing in a file: written to file")
 })

@@ -41,7 +41,7 @@ Synchronous I/O operations block the execution of the program until the operatio
The fs.readFileSync function is used for synchronous file reading. It blocks the execution until the entire file is read, and then it continues with the rest of the code. This is generally not recommended because it can cause the program to become unresponsive during the file read.

-const a=fs.readFileSync("test.txt") //nodejs intetntionally blocks
+const a=fs.readFileSync("test.txt") //nodejs intentionally blocks
console.log(a.toString())
console.log("At last")

@@ -52,9 +52,8 @@ console.log("At last")

-fs.writeFileSync("test.txt","mahima is good girl",() => {    
-    console.log("This is sync: intentionally process is blocked ")
-}) 
+fs.writeFileSync("test.txt","mahima is good girl", 'utf8')  
+console.log("This is sync: the process is intentionally blocked ")

Node.js provides both synchronous and asynchronous file I/O options. Asynchronous I/O is typically preferred for better performance and responsiveness, while synchronous I/O is used only when necessary and with caution, as it can block the program's execution.
\ No newline at end of file

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Review PR #300 and en/file-system/README.md first, then identify which existing language versions need the same content changes. Done means those translations reflect the updated English file.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, nodejs
Domain
documentation, localization
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.