Коллеги, есть вопрос. Кто-нибудь пробовал вести документацию в WordPress? Наши

Question

Технические писатели

Ksenia Yakushina

Коллеги, есть вопрос. Кто-нибудь пробовал вести документацию в WordPress? Наши

хотят туда переехать с Гитбука, Маркетинг всеми конечностями за, а я что-то в сомнениях.
#инструменты

0

28.08.2023

22 ответов

15 просмотров

Ksenia Yakushina Автор вопроса

Vasilisa N
Ну будет как сайт со статьями, почему нет

интересен чужой опыт. оформление, навигация, удобство, плагины, то се

0

28.08.2023

Vasilisa N

Ksenia Yakushina
интересен чужой опыт. оформление, навигация, удобс...

По моему опыту создания базы знаний с веб-интерфейсом могу сказать, что нужно поискать плагины всякие для блогов.. Самый полезный плагин был, как раз, облако тегов (но это и было довольно давно, тогда это было в моде). Мои попытки сделать какой-то адекватный классификатор рубрик ни к чему толковому не привёл, я просто решила задать ряд ключевых слов и всё.

0

28.08.2023

Ksenia Yakushina Автор вопроса

Vasilisa N
По моему опыту создания базы знаний с веб-интерфей...

да, это я начальству уже обозначила. ощущение, что настроить под себя WP можно, но гемора с этим не оберешься

0

28.08.2023

Nick Volynkin

Это ужасно, если кратко

0

28.08.2023

Ksenia Yakushina Автор вопроса

Nick Volynkin
Это ужасно, если кратко

поясни плз, если не сложно. можно в личку

0

28.08.2023

Александр Мокрушин

Вообще реально wp встроить в CI/CD? У нас тоже маркетологи всё хотели сделать на wp. Но удалось отбиться

0

28.08.2023

Ksenia Yakushina Автор вопроса

Александр Мокрушин
Вообще реально wp встроить в CI/CD? У нас тоже м...

у нас ща и гитбук в CI/CD технически не встроен. не было необходимости. не те масштабы, чтобы тот же docs-as-code использовать (думали об этом, но тупо нет ресурсов на изменение и настройку процессов). мне с одной стороны пофиг, на чем работать, с другой стороны - хочется знать реальную ситуацию, чтобы маркетологи на перемены шли тоже с открытыми глазами.

0

28.08.2023

Vladimir Словоблуд

Ksenia Yakushina
у нас ща и гитбук в CI/CD технически не встроен. н...

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

0

28.08.2023

Ksenia Yakushina Автор вопроса

Vladimir Словоблуд
Ну, WP это тоже технология для публикации контента...

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

0

28.08.2023

Eduard Tibet

А какой глубокий смысл этого мероприятия?

0

28.08.2023

Ksenia Yakushina Автор вопроса

Eduard Tibet
А какой глубокий смысл этого мероприятия?

базово на WP хотят переводить сайт, сейчас им занимается сторонняя команда, и это уже всех достало. а гитбук маркетологам глаза мозолит, потому что с него статистика посещений не сайту идет, а самому гитбуку.

0

28.08.2023

Eduard Tibet

Ksenia Yakushina
базово на WP хотят переводить сайт, сейчас им зани...

Не знаю, м.б. конечно у меня предвзятое отношение, но на WP хостятся совсем уж бюджетные компании. Кроме того, там дырок до тучи. А почему нельзя WP - для маркетинга, а ТД - отдельным субдоменом? Ну и пусть у себя в песочнице варятся :) Или хотят поддержку WP тоже повесить?

0

28.08.2023

Ksenia Yakushina Автор вопроса

Eduard Tibet
Не знаю, м.б. конечно у меня предвзятое отношение,...

я и говорю - глаза им мозолит, что наши клиенты статистику гитбуку делают, а не нам) поэтому и доки тоже хотят туда уволочь

0

28.08.2023

Eduard Tibet

А как статистика влияет на продажи? Все-же хорошо :) Это, типа, тихая зависть?

0

28.08.2023

Ksenia Yakushina Автор вопроса

Eduard Tibet
А как статистика влияет на продажи? Все-же хорошо ...

честно говоря, в душе не чаю и чаять не хочу) может, им надо, чтобы из доки к ним тоже клиенты приходили. я не лезу. маркетинг такая штука, раз покажешь интерес, потом подушкой не отмашешься. плавали, знаем.

0

28.08.2023

Eduard Tibet

Ksenia Yakushina
честно говоря, в душе не чаю и чаять не хочу) може...

Так м.б. если узнать истинную причину, можно разрулить это другим способом? Или они не скажут?

0

28.08.2023

Ksenia Yakushina Автор вопроса

Eduard Tibet
Так м.б. если узнать истинную причину, можно разру...

говорят только это :/

0

28.08.2023

Eduard Tibet

Как вариант привести 100500 причин, что документация будет хуже (ну, там, отсутствие версионности и т.п.) - можно нагрести дохрена. И вопрос: вы хотите, чтобы клиенты разочаровывались в документации?

0

28.08.2023

Ksenia Yakushina Автор вопроса

Eduard Tibet
Как вариант привести 100500 причин, что документац...

проблема в том, что у меня этих причин нет) поэтому я и интересуюсь у коллег, кто с этим сталкивался. я сама с WP как пользователь долго работала, но не в рамках чисто технической доки

0

28.08.2023

Тамара

подскажите, а с гитбуком вы используете какие-нибудь плагины?

0

29.08.2023

Ksenia Yakushina Автор вопроса

Тамара
подскажите, а с гитбуком вы используете какие-нибу...

Нет

0

29.08.2023