chore(i18n,docs): processed translations (#44446)

docs/i18n/ukrainian/how-to-work-on-practice-projects.md

@@ -0,0 +1,123 @@
+# How to Work on Practice Projects
+
+The `tools/challenge-helper-scripts` folder contains tools to help facilitate the creation and maintenance of the freeCodeCamp project-based curriculum.
+
+## Create a new project
+
+Run `npm run create-project`. This opens up a command line ui that guides you through the process. Once that has finished, there should be a new challenge in the English curriculum that you can use for the first step of the project. For example, if you created a project called `test-project` in the Responsive Web Design certification, it would be in `curriculum/challenges/english/01-responsive-web-design/test-project`.
+
+If you want to create new steps, the following tools simplify that process.
+
+## create-next-step
+
+A one-off script that will automatically add the next step based on the last step numbered as `step-xxx.md` where `xxx` represents the 3-digit step number of the last step. The challenge seed code will use the previous step's challenge seed code with the editable region markers (ERMs) removed.
+
+**Note:** This script also runs [reorder-steps](#reorder-steps).
+
+### How to run script:
+
+1. Change to the directory of the project.
+2. Run the following npm command:
+
+```bash
+npm run create-next-step
+```
+
+## create-empty-steps
+
+A one-off script that automatically adds a specified number of steps at a specific starting step number. The challenge seed code for all steps created will be empty.
+
+**Note:** This script also runs [reorder-steps](#reorder-steps).
+
+### How to run script:
+
+1. Change to the directory of the project.
+2. Run the following npm command:
+
+```bash
+npm run create-empty-steps start=X num=Y # where X is the starting step number and Y is the number of steps to create.
+```
+
+## create-step-between
+
+A one-off script that automatically adds a new step between two existing consecutive steps. The challenge seed code will use the existing starting step's challenge seed code with the editable region markers (ERMs) removed.
+
+**Note:** This script also runs [reorder-steps](#reorder-steps).
+
+### How to run script:
+
+1. Change to the directory of the project.
+2. Run the following npm command:
+
+```bash
+npm run create-step-between start=X # where X is the starting step number
+```
+
+## delete-step
+
+A one-off script that deletes an existing step and then reorders the remaining step files in the project's folder as well as updates the `challengeOrder` property array in the project's `meta.json` with the new order of the steps.
+
+### How to run script
+
+1. Change to the directory of the project.
+2. Run the following npm command:
+
+```bash
+npm run delete-step num=x # where x is the step number to be deleted.
+```
+
+## reorder-steps
+
+A one-off script that automatically reorders the step files in a project's markdown files based on the filename. It also updates the `challengeOrder` property array in the project's `meta.json` with the new order of the steps.
+
+### Working Example
+
+Let's say you start with the following project structure:
+
+```bash
+step-001.md
+step-002.md
+step-003.md
+step-004.md
+step-005.md
+step-006.md
+```
+
+At some point you decide you need to delete `step-002.md`, because that step is no longer needed. Also, you decide to break down `step-004.md` into three steps instead of just one.
+
+To accomplish this restructure, you would need to delete `step-002.md` and then add a `step-004a.md` and a `step-004b.md`. The new folder structure would look like the following:
+
+```bash
+step-001.md
+step-003.md
+step-004.md
+step-004a.md
+step-004b.md
+step-005.md
+step-006.md
+```
+
+You now need the file names to be `step-001.md` through `step-007.md`, because you removed one but gained two more for a net difference of one file. Also, the frontmatter of each file below a deleted step or added step will need to be modified by making the `title` key value match the new step number. For example, after renaming `step-3.md` to `step-2.md`, you would need to change `step-2.md`'s title from `Step 03` to `Step 02`.
+
+See below for the actual project folder changes needed:
+
+```bash
+step-001.md
+step-003.md renamed to step-002.md and title changes to "Step 2"
+step-004.md renames to step-003.md and title changes to "Step 3"
+step-004a.md renames to step-004.md and title changes to "Step 4"
+step-004b.md renames to step-005.md and title changes to "Step 5"
+step-005.md renames to step-006.md and title changes to "Step 6"
+step-006.md renames to step-007.md and title changes to "Step 7"
+```
+
+Along with the above changes, the `challengeOrder` key in the project's `meta.json` file needs to reflect the new step order. This is needed because each step below a step deletion and/or step addition changes the `title` associated with each of the affected step's challenge `id`.
+
+### How to run script
+
+1. Change to the directory of the project.
+2. Run the following npm command:
+
+```bash
+npm run reorder-steps
+```