Skip to content

docs: онлайн-инструменты для студентов — OneCompiler и работа с GitHub#162

Merged
fey merged 11 commits into
mainfrom
docs/onecompiler-online-editor
Jun 26, 2026
Merged

docs: онлайн-инструменты для студентов — OneCompiler и работа с GitHub#162
fey merged 11 commits into
mainfrom
docs/onecompiler-online-editor

Conversation

@fey

@fey fey commented Jun 26, 2026

Copy link
Copy Markdown
Contributor

Зачем

Даём студентам альтернативу для запуска кода и SQL прямо в браузере и понятную инструкцию по сдаче решения через GitHub. Особенно важно для SQL-студентов: в OneCompiler сразу доступна готовая PostgreSQL.

PR объединяет две связанные статьи (раньше были в #162 и #163) — они ссылаются друг на друга относительными ссылками.

Статьи

1. «Онлайн-редактор OneCompiler» (docs/project-work/onlain-redaktor-onecompiler/)

  • что это и где пригодится (альтернатива Codespaces + эксперименты с кодом);
  • выбор языка (/python, /javascript, /php, /go, /java, /postgresql + переключатель);
  • запуск кода: пример на Python (скриншот) + сниппеты JS/PHP/Go/Java; работа с БД (SQL);
  • как поделиться кодом по ссылке (Share → Public/Unlisted/Private);
  • загрузка решения на GitHub — ссылкой на вторую статью.

2. «Как работать с GitHub через веб-интерфейс» (docs/project-work/rabota-s-github-cherez-veb-interfeys/)

  • для всех направлений (аналитика, тестирование, первые проекты);
  • загрузка готовых файлов (Add file → Upload files), создание файла, редактирование, коммит.

Связи между статьями

Все внутренние ссылки — относительные /docs/...md (нативный механизм Docusaurus, валидируются на сборке onBrokenLinks: throw):

  • OneCompiler ↔ «Как практиковаться в выполнении SQL запросов»;
  • OneCompiler → «Как работать с GitHub через веб-интерфейс»;
  • GitHub-статья → Codespaces и OneCompiler;
  • ссылки на Codespaces приведены к тому же формату.

Скриншоты аннотированные: img-192/193/195/196/197 (OneCompiler), img-198…203 (GitHub). Примеры кода проверены прогоном. Локальная сборка docusaurus build проходит.

🤖 Generated with Claude Code

fey and others added 2 commits June 26, 2026 16:31
Добавлена статья в раздел «Проекты»: что такое OneCompiler, как
открыть редактор, написать и выполнить запрос (пример на SQL/PostgreSQL),
как готовить файлы решения и загружать их на GitHub через веб-интерфейс.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Статья переименована в «Онлайн-редактор OneCompiler» и расширена:
вводная часть про сервис, позиционирование как альтернатива Codespaces
и инструмент для общих экспериментов с кодом, выбор языка, примеры
запуска на Python/JS/PHP/Go/Java + пример с БД, секция «поделиться
кодом» (Share → видимость). Добавлены скриншоты img-195..197.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@fey fey changed the title docs: онлайн-редактор OneCompiler для работы над проектом docs: онлайн-редактор OneCompiler (мультиязычная статья) Jun 26, 2026
fey and others added 5 commits June 26, 2026 17:06
MDX не принимает <!-- -->; заменил аннотации на {/* ... */}.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Общая статья для проектов, где решение сдаётся через GitHub
(аналитика, тестирование, первые проекты): загрузка готовых файлов
(Add file → Upload files), создание файла (Create new file),
редактирование (карандаш Edit) и подтверждение через Commit changes.
Скриншоты img-198..202 сняты на github.com/fey/example.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Двусторонняя связь статей через docusaurus-ссылки (/docs/...md,
валидируются на сборке). Ссылку на Codespaces в статье OneCompiler
тоже привёл к этому формату.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@fey fey changed the title docs: онлайн-редактор OneCompiler (мультиязычная статья) docs: онлайн-редактор OneCompiler (альтернатива для студентов, важно для SQL) Jun 26, 2026
fey and others added 3 commits June 26, 2026 18:13
Заменены скриншоты на аннотированные (языки, запуск Python, SQL, Share),
добавлен стартовый экран PostgreSQL в секцию про БД. Раздел про загрузку
артефактов на GitHub заменён ссылкой на отдельную статью «Как работать
с GitHub через веб-интерфейс». Убраны ANNOTATION-плейсхолдеры,
удалён неиспользуемый img-194.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
После объединения статей в один PR ссылки OneCompiler→GitHub и
GitHub→{Codespaces,OneCompiler} переведены с полных URL на /docs/...md
(валидируются на сборке).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@fey fey changed the title docs: онлайн-редактор OneCompiler (альтернатива для студентов, важно для SQL) docs: онлайн-инструменты для студентов — OneCompiler и работа с GitHub Jun 26, 2026
Разделил два случая: перетаскивание папки при загрузке и путь со слешем
при создании файла. По правке ревьюера.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@fey fey marked this pull request as ready for review June 26, 2026 14:56
@fey fey merged commit 135cfd6 into main Jun 26, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant