Site Rules updates & Static pages / Обновления текста правил и статические страницы сайта

[paul-k-pastvu]

Сейчас текст правил на сайте реализован как статичная страница, отображаемая пользователю во всплывающем окне.
См. https://pastvu.com/rules

Был создан отдельный репозитарий в GitHub Pages под "статический" контент (помощь, правила, т.д.) и подключить GitHub Pages (можно даже домен pastvu.com привязать). Можно было бы вносить изменения через PR, отслеживать историю, оперативно менять что либо в тексте.
См. https://github.com/PastVu/pages и отображение https://pages.pastvu.com

Здесь обсуждается внедрение этого репозитория в интерфейс основного сайта.

Связанные темы в новостях (4.11.2015)

• https://pastvu.com/news/130
• https://pastvu.com/news/141?hl=comment-2571156

Связанные задачи: #288, #180

[paul-k-pastvu]

Не правила, но рядом: #252

[kabalin]

#288 тоже

[paul-k-pastvu]

И #180

[aeifn]

На самом деле, правила меняются не настолько часто и не таким большим количеством людей, чтобы делать под них отдельный пункт в админке.
Достаточно напрямую в браузере править файл https://github.com/PastVu/pastvu/blob/master/views/module/diff/rules.pug, или же при помощи pull-request.
К тому же, этот способ уже доставлят версионирование текста.

[paul-k-pastvu]

@aeifn @klimashkin - я правильно понимаю, что https://github.com/PastVu/pastvu/blob/master/views/module/diff/rules.pug - это текущая версия, причем этот текст сейчас отображается и в русской, и в английской версии сайта?

[kabalin]

Да. Для английской отдельный бранч, но текст там тоже русский: https://github.com/PastVu/pastvu/blob/en/views/module/diff/rules.pug Английская версия что на pages, это через автопереводчик пропущено, но вроде бы хорошо перевел, хотя не мешало бы внимательно перечитать.

[kabalin]

Предлагаю правила в GitHub Pages перенести. Создать отдельный репозитарий под "статический" контент (помощь, правила, т.д.) и подключить GitHub Pages (можно даже домен pastvu.com привязать). Можно было бы вносить изменения через PR, отслеживать историю, оперативно менять что либо в тексте.

[paul-k-pastvu]

Два вопроса:

1. как это редактировать через веб?
2. как это будет в итоге прикручено к сайту? Не хотелось бы, чтобы это было на другом домене.

Собственно, у нас же есть тестовая версия. Давайте на ней попробуем вывести ссылки на статические страницы. Ссылка на правила в интерфейсе есть (но она, кстати, должна быть не в подвале, а в шапке сайта). Давайте её переделаем, чтобы она вела на новую статическую страницу.
И там же нужна новая ссылка "Помощь" (Help), которая будут вести на оглавление справочного раздела.

Если всё получится, дальше будум развивать этот блок и обсудим нужность выделения таких страниц по регионам и темам.

[paul-k-pastvu]

И хотелось бы услышать мнение от @klimashkin !

[aeifn]

1. как это редактировать через веб?

форкнуть репозиторий на гитхабе, внести изменения в веб-редакторе на гитхабе, сделать пулл-реквест.
или, если есть прямой доступ к репозиторию: просто внести изменения в веб-редакторе.

2. как это будет в итоге прикручено к сайту? Не хотелось бы, чтобы это было на другом домене.

например, на домене pages.pastvu.com

[kabalin]

форкнуть репозиторий на гитхабе, внести изменения в веб-редакторе на гитхабе, сделать пулл-реквест.
или, если есть прямой доступ к репозиторию: просто внести изменения в веб-редакторе.

Да. В коммите желательно указать причину изменения и сослаться на тикет (если есть).

например, на домене pages.pastvu.com

или docs.pastvu.com

Ссылку "Помощь" предлагаю добавить на сайт когда будет хотя бы одна статическая страница помощи 😃

Еще надо мультиязычность добавить, попробую на выходных, нашел пару примеров как это сделать.

[kabalin]

Добавлена мультиязычность: https://pastvu.github.io/pages/ Инструкция по созданию страниц находится в README. Кстати, не знал что английской версии правил не существует, пришлось для демонстрации концепции многоязычности скопировать пока русскую.

[paul-k-pastvu]

По поводу внутренней организации правил - хороший пример из сходного по идеологии проекта: http://www.plantarium.ru/page/help.html

[mkgrgis]

Отличный пример я бы сказал! Понятность и быстрота выхода на какой-то вопрос образцовые.

[paul-k-pastvu]

Вот нам ещё ссылок накидали в справочный раздел - https://pastvu.com/news/141?hl=comment-2571156
А по архивам новостей этого - россыпи.

[kabalin]

Да, наверное вики-платформа была бы более удобным вариантом для обычных пользователей.

[paul-k-pastvu]

К тому же у нас в сообществе есть сразу несколько вики-админов готовых...
Но это громоздкая отдельная штука, не обязательно её сразу запускать. Вполне можно сначала переключиться на статические страницы.
Нужно, чтобы:

1. в интерфейсе осноного сайта появилась ссылка на справочный раздел (причем отдельно - на русскую и ангдийскую версию)
2. ссылка на текст правил во всплывающем блоке (в подвале сайта)

• либо меняется на статическую ссылку на https://pages.pastvu.com/ru/rules / https://pages.pastvu.com/en/rules
• либо динамически отображает текущую версию этой страницы (чтобы они не "разъехались" вдруг)

После этого я публикую новость с анонсом и начинаю обсуждение структуры и наполнения нового раздела.

[kabalin]

Но это громоздкая отдельная штука, не обязательно её сразу запускать.

Да вики поднять то не сложно на swarm, были бы ресурсы и время настроить сервис и бэкап. Надо все же решить, чтобы не переделывать, на чем мы остановимся. Какой смысл делать структуру в markdown, если рано или поздно придется переносить все на вики (дополнительная работа).

[kabalin]

Документация вынесена в отдельный проект (https://docs.pastvu.com/), таким образом необходимость в редактировании статических страниц внутри приложения отпадает. Для добавления отдельных страниц помощи и прочей информации предлагаю описывать задачи в https://github.com/PastVu/docs