From 9b99a788f602beef3e954cbbdd62e43f0d9045e7 Mon Sep 17 00:00:00 2001
From: AwareFoxy <vgstecker@gmail.com>
Date: Mon, 30 Sep 2024 14:25:18 +0300
Subject: [PATCH] translated git for ss14 developer and how do i code

---
 .../setup/git-for-the-ss14-developer.md       | 94 +++++++++----------
 .../general-development/setup/howdoicode.md   | 50 +++++-----
 2 files changed, 71 insertions(+), 73 deletions(-)

diff --git a/src/ru/general-development/setup/git-for-the-ss14-developer.md b/src/ru/general-development/setup/git-for-the-ss14-developer.md
index 256e58a2b..0da53bbd4 100644
--- a/src/ru/general-development/setup/git-for-the-ss14-developer.md
+++ b/src/ru/general-development/setup/git-for-the-ss14-developer.md
@@ -649,7 +649,7 @@ git branch -d another-feature
 - **'Сабмодули'** это репозитории, которые находятся внутри другого репозитория.
 - **'Форки'** это репозитории, которые основаны на другом репозитории. Если вы собираетесь сделать ПР в репозиторий SS14, вам нужно сначала его форкнуть.
 - **"Рабочее дерево"**(Working tree) - это все файлы, папки и прочее, что есть в репозитории.
-- **'Staging'** означает добавление (с помощью `git add`) изменений из вашего рабочего дерева в «staging area», где над ними могут быть произведены некоторые действия.
+- **'Стейджинг'**(Staging) означает добавление (с помощью `git add`) изменений из вашего рабочего дерева в «staging area», где над ними могут быть произведены некоторые действия.
 - **'Коммиты'** это снимки рабочего дерева репозитория в определённый момент времени. По сути, это точка сохранения. Коммит» - это просто список файлов, которые были изменены с момента последнего коммита, а изменения, которые "коммитнули", - это изменения, которые вы "стейджнули"
 - **'Чекаут'**(Checkout) - это акт переключения на другую ветку, чтобы вы могли работать с ней или просматривать её изменения локально.
 - **'Мерджинг'** это акт интеграции изменений из одной ветки в другую ветку.
@@ -661,125 +661,123 @@ git branch -d another-feature
 
 Существует гораздо больше команд и концепций, чем эта, но это все, что вам действительно нужно знать для базовой разработки.
 
-# Appendix A: Helpful tips and tricks
+# Приложение A: Полезные советы и рекомендации
 
-There's some stuff I didn't cover, but you'll almost inevitably have to do at some point. I'll cover these all **exclusively as git commands in Git Bash** quickly, but they're not too hard to figure out in the other programs (same keywords, just look for those). I recommend using their specific guides because I don't know TortoiseGit / SmartGit / GitKraken / Github Desktop well enough to help you with more advanced stuff.
+Есть вещи, которые я не описал, но они почти неизбежно понадобятся вам в какой-то момент. Я быстро расскажу обо всех этих **исключительно git-командах в Git Bash**, но их несложно найти и в других программах (те же ключевые слова, просто ищите их). Я рекомендую использовать их специальные руководства, потому что я не знаю TortoiseGit / SmartGit / GitKraken / Github Desktop достаточно хорошо, чтобы помочь вам с более сложными вещами.
 
-One note since it comes up a lot here: **`HEAD` is a fancy name for the commit that you're currently on**. Nothing more than that. Branches are also technically fancy names for commits, but you don't need to know that yet.
+Одно замечание, поскольку оно часто встречается здесь: **`HEAD` - это модное название коммита, на котором вы сейчас находитесь**. Не более того. Ветви тоже технически являются причудливыми названиями коммитов, но вам это пока не нужно знать.
 
-A lot of these can be found probably more eloquently in Oh Shit, Git?! (see resources above)
+Многое из этого можно найти в «Ёбанный Git!!!», (см. ресурсы выше)
 
+## Мердж Конфликты
 
-## Resolving merge conflicts
+*WIP Я напишу лучшее руководство для этого позже, потому что это важно*
 
-*WIP i'll write a better guide for this later because it's important*
+Мерзкий маленький мейнтейнер сказал вам убрать «мердж конфликты», иначе ваш PR «не будет мерджнут. Вот засранец! К счастью, это не так уж сложно.
 
-A nasty little maintainer has told you to 'resolve conflicts' or your PR 'wont be merged'. What an asshole! Thankfully, it's not too hard.
+Сначала вам нужно обновить локальную ветку `master branch`. Как это сделать, смотрите выше.
 
-First, you're going to want to update your local `master branch`. See above for how to do that.
+Когда вы запустите `git merge master [local branch]`, он либо сделает это чисто (ура), либо скажет, что вам нужно разрешить конфликты (меххх). 
 
-When you run `git merge master [local branch]`, it'll either do it cleanly (woohoo) or tell you you have to resolve conflicts (wahhhh). 
+Чтобы разрешить конфликты вручную, достаточно зайти в конфликтующие файлы, удалить всю ерунду типа `>>>>HEAD` и `===== <<<<master` (просто отмечает, откуда произошли изменения), а затем отредактировать файл так, чтобы он правильно объединял оба набора изменений. Иногда это легко, иногда трудно. Если это сложно, то вы, вероятно, знаете, что делаете. После этого просто сделайте `git commit`.
 
-All you need to do to resolve conflicts manually is go into the files that are conflicting, remove all the `>>>>HEAD` and `===== <<<<master` nonsense (just notates where the changes originated) and then edit the file so that it properly integrates both sets of changes. Sometimes this is easy, sometimes it's hard. If it's hard, you probably know what you're doing. After that, just `git commit`.
+В Atlassian есть очень хорошее руководство по этому вопросу [здесь](https://www.atlassian.com/git/tutorials/using-branches/merge-conflicts)
 
-Atlassian has a really good guide for this [here](https://www.atlassian.com/git/tutorials/using-branches/merge-conflicts)
+## Проверяем историю
 
-## Checking history
+`git log --oneline` - ваш друг. Он показывает короткие хэши коммитов (уникальные идентификаторы коммитов), их сообщения, а также их ветки и теги.
 
-`git log --oneline` is your friend. It shows short commit hashes (unique IDs for commits), their messages, and their branches and tags.
+## Избавление от локальных изменений
 
-## Getting rid of local changes
-
-You might have accidentally made changes you didn't want to, and you don't want to bother with making an entirely new branch or something--but you haven't committed those changes yet.
+Возможно, вы случайно внесли изменения, которых не хотели, и не хотите возиться с созданием совершенно новой ветки или чего-то подобного - но вы еще не коммитнули эти изменения.
 
 ```
 git reset --hard HEAD
 ```
 
-This just means 'change the working tree to the current commit, before any local changes. Or else.' **You can't retrieve those local changes if you do this, so be wary.**
+Это просто означает «изменить рабочее дерево на текущий коммит, до любых локальных изменений. **Вы не сможете вернуть эти локальные изменения, если сделаете это, так что будьте осторожны.**
 
-## Unstaging changes
+## Снятие изменений с постановки
 
-Ah shit, I just staged RobustToolbox by accident. No fear!
+Вот блядь, я случайно стейджнул RobustToolbox. Не страшно!
 
 ```
 git reset HEAD [file]
 ```
 
-Alternatively, to unstage everything:
+В качестве альтернативы, чтобы удалить все:
 
 ```
 git reset HEAD
 ```
+## Отмена сделанного вами коммита
 
-## Reverting a commit you made
-
-Oh shit, your xenomorph erotica made its way into a commit/you accidentally committed a submodule! What now? Well, there's two solutions:
+Вот чёрт, ваш ЕРП спрайт ксеноморфа случайно попал в коммит/вы случайно закоммитили в сабмодуль! Что теперь? Есть два решения:
 
 ```
 git revert HEAD
 ```
 
-This makes a new commit undoing the current commit, and then commits it. Hehe commit. 
+Это создаст новый коммит, отменяющий текущий коммит, а затем закоммитит его. Хе-хе коммит. 
 
-If you want to undo a different commit, you can check its hash in `git log --oneline` and then call `git revert [commit hash]`. Git has a more robust system for doing this; you can do `git revert HEAD~1` to undo the commit before your current one or `git revert HEAD~2` to revert the one before that. The `~1` just means '1 commit before HEAD'.
+Если вы хотите отменить другой коммит, вы можете проверить его хэш в `git log --oneline` и затем вызвать `git revert [commit hash]`. В Git'е есть более надёжная система для этого; вы можете сделать `git revert HEAD~1`, чтобы отменить коммит перед текущим, или `git revert HEAD~2`, чтобы отменить тот, который был перед этим. `~1` просто означает «1 коммит перед HEAD».
 
-Alternatively,
+Альтернативный вариант,
 
 ```
 git reset --hard HEAD~1
 ```
 
-**I don't recommend doing this unless you're fully aware of what you're doing.**
+**Я не рекомендую делать это, если вы не осознаёте, что делаете.**
 
-For when you REALLY don't want anyone to know about that xenomorph erotica you just made. This method rewrites history, so it isn't the best for a collaborative environment. If you do this, you'll need to force push (`git push origin [branch] --force`) or else it won't work. Force pushing can be dangerous, so again, be sure you know what you're doing.
+Для тех случаев, когда вы РЕАЛЬНО не хотите, чтобы кто-то узнал об ерп ксеноморфе, которого вы только что коммитнули. Этот метод переписывает историю, поэтому он не подходит для совместной разработки. Если вы сделаете это, вам нужно будет выполнить принудительный push (`git push origin [branch] --force`), иначе он не сработает. Принудительный пуш может быть опасным, поэтому, опять же, убедитесь, что вы знаете, что делаете.
 
+## Проверка изменений в PR локально
 
-## Checking out a PR's changes locally
-
-Ok, this one is a little difficult. There's a couple ways to do this:
+Окей, это немного сложно. Есть несколько способов сделать это:
 
 ### Github CLI
 
-Install github's fancy CLI and do this:
+Установите модный CLI от github и сделайте следующее:
 
 ```
-gh pr checkout [pr number]
+gh pr checkout [номер ПРа]
 ```
 
-Neat.
+Аккуратно.
 
-### Changing .git/config
+### Изменение .git/config
 
-Go into your .git folder (hidden by default--may need to enable showing hidden folders in Windows), and open up the 'config' file. There should be a bit that looks something like:
+Зайдите в папку .git (по умолчанию она скрыта - возможно, потребуется включить отображение скрытых папок в Windows) и откройте файл 'config'. Там должен быть фрагмент, который выглядит примерно так:
 
 ```
-[remote "upstream"]
+[remote «upstream»]
 	url = https://github.com/space-wizards/space-station-14
 	fetch = +refs/heads/*:refs/remotes/upstream/*
 ```
 
-Add a line to this that reads `fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*`, so that section should now look like:
+Добавьте к этому строку, которая гласит `fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*`, так что теперь эта секция должна выглядеть следующим образом:
 
 ```
-[remote "upstream"]
+[remote «upstream»]
         url = https://github.com/space-wizards/space-station-14
         fetch = +refs/heads/*:refs/remotes/upstream/*
         fetch = +refs/pull/*/head:refs/remotes/upstream/pr/*
 ```
 
-Now, `git fetch upstream`. This method is great if you're a maintainer, but it also.. fetches every branch that's still up from every PR that's been opened, so not fantastic if you just wanted one thing. From here, you can `git checkout upstream/pr/[pr number]` to check out their branch. This is basically what GitHub CLI does but less sophisticated.
+Теперь пропишите `git fetch upstream`. Этот метод хорош, если вы мейнтейнер, но он также... собирает все ветки, которые еще не закрыты, из всех PR, которые были открыты, так что это не лучший вариант, если вам нужно только что-то одно. Отсюда вы можете сделать `git checkout upstream/pr/[номер ПРа]`, чтобы проверить их ветку. В принципе, это то же самое, что делает GitHub CLI, но менее сложное.
+
 
-### Adding a new remote
+### Добавление нового ремоута
 
-This method kinda sucks because it takes a while but if you want to check out someone else's fork of the game and their branches it's pretty nice.
+Этот метод немного отстойный, потому что занимает много времени, но если вы хотите проверить чужой форк игры и его ветки, то это довольно удобно.
 
-Not actually that hard but its confusing if you don't know Git very well. Set up a remote to the user's remote repository, fetch their branches, and then checkout their branch:
+На самом деле это не так уж и сложно, но если вы не очень хорошо знаете Git, это может сбить с толку. Настройте удалённый доступ к удалённому репозиторию пользователя, получите его ветки, а затем проверьте его ветку:
 
 ```
-git remote add [username] https://github.com/[username]/space-station-14
-git fetch [username]
-git checkout [username]/[branch name]
+git remote add [имя пользователя] https://github.com/[имя пользователя]/space-station-14
+git fetch [имя пользователя]
+git checkout [имя пользователя]/[название ветки]
 ```
 
-This also lets you make PRs to their remote branch, if you so desired.
+Это также позволит вам делать PR в их удаленную ветку, если вы того пожелаете.
\ No newline at end of file
diff --git a/src/ru/general-development/setup/howdoicode.md b/src/ru/general-development/setup/howdoicode.md
index 278947a54..067d0c1f7 100644
--- a/src/ru/general-development/setup/howdoicode.md
+++ b/src/ru/general-development/setup/howdoicode.md
@@ -1,42 +1,42 @@
-# How do I code? (I don't know how to program.)
-Below are some useful links for learning programming. If you get stuck, don't be afraid to ask us questions in the `#howdoicode` channel on our [discord](https://discord.gg/ss14). If you can't find what you're looking for in one of these links, try googling "how to do X in csharp". You'll usually find several examples.
+# Как написать код? (Я не знаю, как программировать.)
+Ниже приведены полезные ссылки для изучения программирования. Если вы застряли, не бойтесь задавать нам вопросы в канале `#разработка` в нашем [дискорде](https://discord.gg/ss14). Если вы не можете найти то, что ищете, в одной из этих ссылок, попробуйте набрать в гугле «как сделать X в csharp». Обычно вы найдете несколько примеров.
 
-If you have some experience (read: understand things like "classes" and "control flow") and would rather learn by doing, try looking at the Issues marked as [Beginner Friendly](https://github.com/space-wizards/space-station-14/labels/Beginner%20Friendly) on the Github repo. They are usually pretty simple and someone can always help you out on the discord. 
+Если у вас есть некоторый опыт (понимание таких вещей, как «классы» и `control flow`) и вы предпочитаете учиться на практике, попробуйте просмотреть Issue, помеченные как [Beginner Friendly](https://github.com/space-wizards/space-station-14/labels/Beginner%20Friendly) на репозитории Github. Обычно они довольно просты, и кто-нибудь всегда может помочь вам в discord. 
 
-You may have come here simply wanting to add items. It's possible to do that without learning how to program, though you'll be limited in what kind of functionality you can give them. You'll still probably need to learn Git (read on!)
+Возможно, вы пришли сюда, чтобы просто добавить предметы в игру. Это можно сделать и без изучения программирования, хотя вы будете ограничены в функциональности. Вам все равно придется изучить Git (читайте дальше!).
 
-If you want to do anything more complicated, I recommend you read the rest of [**Getting Started**](./setting-up-a-development-environment.md), and then start reading **SS14 By Example**, which goes through many common activities and how to do them.
+Если вы хотите сделать что-то более сложное, я рекомендую вам прочитать остальную часть [**Getting Started**](./setting-up-a-development-environment.md), а затем начать читать **SS14 By Example**, где рассматриваются многие распространенные действия и их выполнение.
 
-## Tutorials
+## Учебники
 
 ### C#
-The programming language you'll be using to contribute to SS14. If you've never programmed before, C# is a solid pick for a first language!
+Язык программирования, который вы будете использовать для работы над SS14. Если вы никогда раньше не программировали, C# - отличный вариант для вашего первого языка!
 
-**[C# A Player's Guide 5th Edition](https://www.amazon.com/dp/0985580151)**
-A very engaging book for beginners to C#. Very modern, making use of C#10 and .NET 6 with tons of projects and challenges to actually make use of your coding skills. Highly recommended. Buy whatever the newest edition is (regardless of what this says), as we always stay up to date.
+**[C# A Player's Guide 5th Edition](https://www.amazon.com/dp/0985580151)**.
+Очень увлекательная книга для начинающих изучать C#. Очень современная, использующая C#10 и .NET 6, с тоннами проектов и задач, чтобы реально использовать ваши навыки кодирования. Настоятельно рекомендуем. Покупайте самое новое издание (независимо от того, что написано на сайте), так как мы всегда идем в ногу со временем.
 
-**[CSharp Fundamentals for Absolute Beginners | Channel 9](https://channel9.msdn.com/Series/CSharp-Fundamentals-for-Absolute-Beginners)**
-A video series covering the absolute basics of programming, C# style. Also walks you through installing an IDE (a program that makes it much easier for you to write code).
+**[Основы CSharp для абсолютных новичков | 9 канал](https://channel9.msdn.com/Series/CSharp-Fundamentals-for-Absolute-Beginners)**.
+Серия видеороликов, посвященных абсолютным основам программирования в стиле C#. Также рассказывается об установке IDE (программы, которая значительно облегчает написание кода).
 
-**[C# 101 | Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/tour-of-csharp/tutorials/)**
-The videos are so-so (skimming over terms like "variable", "string", and "interpolation"), but the tutorials themselves are solid. If you prefer interactive written tutorials over watching videos, they're completable in your web browser [here](https://docs.microsoft.com/en-us/dotnet/csharp/tour-of-csharp/tutorials/hello-world).
+**[C# 101 | Microsoft](https://docs.microsoft.com/en-us/dotnet/csharp/tour-of-csharp/tutorials/)**.
+Видеоролики - так себе (беглое знакомство с такими терминами, как «переменная», «строка» и «интерполяция»), но сами туториалы - добротные. Если вы предпочитаете интерактивные туториалы, а не видео, их можно просмотреть в веб-браузере [здесь](https://docs.microsoft.com/en-us/dotnet/csharp/tour-of-csharp/tutorials/hello-world).
 
-**Microsoft's various C# guides**
-For those who already have some experience (read: knows what "modern, object-oriented, and type-safe programming language" is, since that's the first line), the [getting started guide](https://docs.microsoft.com/en-us/dotnet/csharp/getting-started/) gives some basic examples on how to use C# and shows how to use Visual Studio for writing C#. The [programming guide](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/) gives more specific examples of C# language features.
+**Различные руководства Microsoft по C#**.
+Для тех, кто уже имеет некоторый опыт  (знает, что такое современный, объектно-ориентированный и подобное), в руководстве [Getting Start Guide](https://docs.microsoft.com/en-us/dotnet/csharp/getting-started/) приведены основные примеры использования C# и показано, как использовать Visual Studio для написания текстов на C#. В [руководстве по программированию](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/) приведены более конкретные примеры использования возможностей языка C#.
 
-**[Learn C# in Y minutes](https://learnxinyminutes.com/docs/csharp/)**
-Reference sheet presented through a massive C# file. Again, this is more useful for those who already understand how to program and just need a quick reference for what the syntax is. 
+**[Выучить C# за Y минут](https://learnxinyminutes.com/docs/csharp/)**.
+Справочный материал, представленный в виде массивного файла C#. Опять же, это полезно для тех, кто уже понимает, как программировать, и просто нуждается в кратком справочнике по синтаксису. 
 
 ### Git
-Git is "version control software", aka the reason a bunch of people can contribute to one project without it devolving into chaos. Git's probably going to seem like opaque bigbrain nonsense for a bit, but then it clicks and then you, too, get to try to convince people "it's actually really simple, see, imagine you have a tree--"
+Git - это «программное обеспечение для контроля версий», а также причина, по которой куча людей может вносить свой вклад в один проект, не превращая его в хаос. Git, вероятно, будет казаться непрозрачной ерундой для большого мозга, но потом все станет понятно, и вы тоже будете пытаться убедить людей: «На самом деле все очень просто, смотрите, представьте, что у вас есть дерево...»
 
-**[Git for the SS14 Developer](./git-for-the-ss14-developer.md)**
-Good on its own and has a lot of resources for learning Git further. Explains the what, the why, its role in SS14, etc.
+**[Git для разработчика SS14](./git-for-the-ss14-developer.md)**.
+Хорош сам по себе и содержит множество ресурсов для дальнейшего изучения Git. Объясняет, что, почему, его роль в SS14 и т. д.
 
-**[Learn Git Branching](https://learngitbranching.js.org/)**
-An interactive, gamified way of learning Git. Plays well with "Git for the SS14 Developer" so you can develop a more intuitive understanding of what it's talking about.
+**[Learn Git Branching](https://learngitbranching.js.org/)**.
+Интерактивный, геймифицированный способ изучения Git. Хорошо сочетается с «Git для разработчика SS14», чтобы вы могли более интуитивно понять, о чем идет речь.
 
-### Other
+### Другое
 
-**[CS50 | Harvard](https://cs50.harvard.edu/college/2021/spring/weeks/6/)**
-Teaches computer programming and how computers work. Covers a broad swathe of topics (different languages like C and Python, algorithms, memory, etc). To oversimplify: learning things like "for loops" and "if statements" teaches you how to talk the talk. Breaking down why algorithms work, the differences between programming languages, actually writing programs to solve puzzles, etc. is the "walk the walk" part. You can get started without this and pick it up naturally over time, though it's a slower process.
+**[CS50 | Harvard](https://cs50.harvard.edu/college/2021/spring/weeks/6/)**.
+Обучает компьютерному программированию и тому, как работают компьютеры. Охватывает широкий круг тем (различные языки, такие как C и Python, алгоритмы, память и т.д.). Упрощенно говоря, изучение таких вещей, как «циклы for» и «операторы if», научит вас говорить. Разбор того, как работают алгоритмы, различия между языками программирования, реальное написание программ для решения головоломок и т.д. - это и есть «хождение по улицам». Вы можете начать без этого и со временем подтянуться, хотя это более медленный процесс.
\ No newline at end of file