Список статей пользовательской документации (сейчас wordpress.org/documentation, до 17 января 2023 года: wordpress.org/support) сайта «WordPress.org». Лучше организованный и расположенный на одной странице. (На сайте «WordPress.org» статьи просто собраны в кучу, читать неудобно. Поэтому я решил составить более удобный список, похожий на содержание учебника.)
Пока что я разобрал только англоязычный раздел документации, так как он самый большой. Поскольку в списке содержатся статьи на английском языке, то сам список тоже составлен на английском языке.
-
into-categories.md — список всех статей пользовательской документации, содержащихся в категориях пользовательской документации сайта «WordPress.org». Разбивка на категории сайта «WordPress.org» сохранена;
-
without-categories.md — я пока не знаю, буду ли составлять новый список статей со своей разбивкой. Пока можно пользоваться тем, который я составил до изменения структуры категорий пользовательской документации на сайте «WordPress.org» 17.01.2023 года.
В связи с изменением с 17.01.2023 года структуры категорий статей пользовательской документации на сайте «WordPress.org» разбивка на категории в этих списках теперь не совпадает с категориями на сайте «WordPress.org». Однако, эти списки по-прежнему можно использовать для изучения веб-приложения «WordPress», так как ссылки на статьи в них я обновил. Эти три списка помещены в папку «until-2023-01-17», в которой есть свой файл «README.md».
-
Список предлагается дополнительно к категориям, а не вместо них. В этот список не обязательно включать все статьи, имеющиеся на сайте «WordPress.org»: для начинающего пользователя достаточно некой группы основных статей, а остальные он уже сможет найти сам.
-
Система организации статей с помощью категорий (как в пользовательской документации «WordPress.org») работает, если в каждой категории статей не очень много. Например, не более десятка. Если статей в категории становится много, требуется дополнительная внутренняя организация.
-
Начинающему пользователю (и не только начинающему) часто хочется охватить всё одним взглядом. Поэтому полезно иметь под рукой ссылки на все статьи на одной странице, а не на множестве страниц, как в случае с использованием категорий.
-
Начинающему пользователю непонятно, в каком порядке читать статьи из категорий, так как внутри категорий статьи собраны кучей, а не последовательным списком. Предлагаемый список имеет определенную рекомендуемую последовательность чтения статей, поэтому у начинающего пользователя меньше вопросов, можно сразу начать чтение статей, а не думать, какую из них читать в первую очередь.
Примеры последовательного списка чтения статей, реализованные в других проектах:
- руководства (handbooks) на сайте make.wordpress.org;
- книга «Pro Git» на сайте git-scm.com/book;
- справочное руководство «MySQL 8.0 Reference Manual» на сайте dev.mysql.com/doc/refman/8.0/en/;
- руководство «PHP Manual» на сайте www.php.net/manual/en/;
- разделы справки в «LiveJournal» («Живом Журнале») на сайте www.livejournal.com/support/faq/
и так далее (есть еще много примеров).