Back-port 2017-04 it's all fine article

This commit is contained in:
2017-11-24 03:09:01 +07:00
parent 9c70de9467
commit 400d49970e
12 changed files with 480 additions and 2 deletions

View File

@@ -0,0 +1,35 @@
Title: Всё проходит хорошо
Date: 2017-04-07 00:00
Category: News
Slug: its-all-fine
Lang: ru
![ItsAllFine][screenshot]
Эта статья рассказывает о создании первых четырёх самоучителей OpenSceneGraph в марте 2017.
[Первые четыре самоучителя OpenSceneGraph](https://github.com/OGStudio/openscenegraph-cross-platform-guide/) объясняют, как создать модель куба в Blender и затем отобразить её на Linux, macOS или Windows с помощью osgviewer, стандартного инструмента OpenSceneGraph.
Процесс создания одного самоучителя оказался довольно утомительным, т.к. он состоит из следующих задач:
0. Записать видео с одним или более шагами
0. Назвать эти шаги как можно яснее
0. Выбрать те части видео, которые непосредственно показывают шаг
0. Убрать те части видео, которые не имеют значения, например, ожидание сборки
0. Выбрать один кадр, лучше всего передающий смысл этого шага, например, набор команды
0. Добавить детальное описание в статью, почему этот шаг был необходим
0. Перечитать статью
0. Поправить опечатки и монтаж видео
0. Пересмотреть полное видео
0. Загрузить видео на YouTube с временными отметками шагов для упрощения навигации
Некоторые из этих задач приходилось повторять несколько раз до тех пор, пока комбинация видео, текста и статьи не получилась целостной.
Всего мы потратили 30 часов на создание самоучителей. В ходе их создания мы почерпнули много нового, что поможет нам улучшить обучающие материалы наших технологий в будущем. Сейчас мы ещё не в курсе, как именно эти материалы будут выглядеть, но они точно будут лучше.
На этом мы заканчиваем рассказ о создании первых четырёх самоучителей OpenSceneGraph в марте 2017.
[screenshot]: {attach}/images/2017-04_its-all-fine.png

View File

@@ -0,0 +1,35 @@
Title: It's all fine
Date: 2017-04-07 00:00
Category: News
Slug: its-all-fine
Lang: en
![ItsAllFine][screenshot]
This article describes creation of the first four OpenSceneGraph tutorials in March 2017.
The [first four OpenSceneGraph tutorials](https://github.com/OGStudio/openscenegraph-cross-platform-guide/) explain how to create a cube model with Blender and display the model under Linux, macOS, or Windows using OpenSceneGraph tool called osgviewer.
The whole process of creating a single tutorial turned out to be pretty daunting because it includes several tasks:
0. Record original video depicting one or more steps
0. Name the steps as clear as possible
0. Select the parts of the video that display the step
0. Remove the parts of the video that bare no value, e.g., waiting in the middle of compilation
0. Select a single frame to best represent current step, e.g., typing a specific command
0. Add a detailed description to article, why current step should have been taken
0. Proof-read the article
0. Correct typos and video timing
0. Review the whole video
0. Upload the video to YouTube with timestamps of steps for easier navigation
Some of those tasks had to be repeated multiple times until the combination of video, text, and article was clear and logical.
Overall, it took us 30 hours to create the tutorials. The whole process gave us a lot of experience, which will help us in shaping learning materials for our technologies in the future. We don't know how they will look like exactly, but they will definitely be better.
That's it for describing creation of the first four OpenSceneGraph tutorials in March 2017.
[screenshot]: {attach}/images/2017-04_its-all-fine.png