Пока раздел небольшой - пишем все на одной странице.
При разрастании подразделов - выносим подразделы на новую страницу.
Если есть желание комментировать какой-то подраздел - то тоже выносим на новую страницу.
Каждое предложение желательно делать полным, но коротким (80-127 букв).
Пишите так, как обычно говорите.
Главное - чтобы текст понимал тот, кто его читает.
Одна мысль - один абзац.
Лучше напишите 3 страницы неправильно и плохо, чем 1 предложение правильно и идеально.
Страница заполняется в произвольном порядке.
Нужно сделать всю документацию проекта за одну неделю к пятнице.
Это версия 1
Должны быть все документы (страницы сайта).
Каждый документ должен быть сделан на 1%
Если что-то утверждаете, то укажите ссылку на информацию.
Если есть замечания и комментарии к странице - для этого есть специальное место внизу каждой страницы.
Минимально используйте выделение цветом или шрифтом.
Пока раздел небольшой - пишем все на одной странице.
При разрастании подразделов - выносим подразделы на новую страницу.
Если есть желание комментировать какой-то подраздел - то тоже выносим на новую страницу.
Не бойтесь делать много страниц, размер ничем не ограничен.
Для текста обязательны смысловая законченность, целостность и связность.
Обязательно использование логики в построении предложений.
Про логику есть тут
Научный метод, логика, апгрейд мозга
Обратите внимание на стиль написания текста.
Каждое предложение желательно делать полным, но коротким (80-127 букв).
Это не всегда удобно и красиво, зато позволяет более корректно реализовать автоматический перевод сайта.
Опять же, без фанатизма! Каждое правило можно иногда нарушать.
Пишите так, как обычно говорите.
Не пытайтесь точно формулировать свои мысли псевдо-научным языком.
Представьте, что вам надо объяснить свои мысли ученику средней школы.
Ну или иностранцу, который не очень хорошо знает ваш родной язык.
Главное - чтобы текст понимал тот, кто его читает.
Просьба писать без псевдонаучных вступлений, типа "вряд ли кому надо объяснять про пользу витаминов".
Это трюизм, он не несет в себе полезной информации.
Да и не всегда то, что выдается за общеизвестное является общеизвестным.
Например, про пользу или вред витаминов.
Предложения должны быть короткими.
Минимум деепричастных оборотов и сложных конструкций.
Одна мысль - один абзац.
Если не можете написать коротко и понятно - тренируйтесь.
Напишите длинное предложение, как получится.
Потом разбейте его на три коротких.
Не используйте слово "уникальная".
Если кто-то так считает - значит просто плохо смотрел Интернет.
Априори нет уникальных продуктов.
Забудьте про уникальность.
Никому она не интересна.
Все, что вы напишите - всегда будет неправильно и плохо с вашей точки зрения.
Но лучше напишите 3 страницы неправильно и плохо, чем 1 предложение правильно и идеально.
Большинство людей могут исправить неправильный текст и точно знают, что в нем неправильно.
Но эти люди обычно очень плохо могут создать новый текст с нуля.
Jedem - das Seine!
Каждому - свое!
Творите, создавайте текст!
Если что-то уже будет - всегда найдется редактор, который исправит текст.
Хуже, если ничего нет вообще.
Страница заполняется в произвольном порядке.
Если тупите более 10 минут, и не знаете, что писать в каком-то разделе - бросаете и переходите к другому разделу.
В начале пишете только мысли и ключевые слова.
Но заполняете всю страницу, как можно больше разделов.
Если возникла идея или какие-то ключевые фразы, то сразу пишите, может быть иногда даже не в тот раздел.
Потом поправите.
Когда заполнили ключевые слова и немного описали свои мысли о каждом разделе, то можно идти далее.
Потом расширяйте и дополняйте текст.
Но опять же, не в каком-то одном месте, а везде.
Не делайте один документ (страницу) правильно и полностью!
Не пишите много в одном разделе.
Нужно поровну заполнить ВСЕ разделы.
Потом можно расширять каждый раздел.
Ориентируйтесь на контрольные сроки:
Любой раздел нужно сделать максимум за неделю.
Позднее он просто будет не нужен.
Причем за эту неделю нужно пройтись по всему разделу 3-4 раза.
От начала до конца.
Тогда это нормальный режим работы по проекту.
Нужно сделать всю документацию проекта за одну неделю к пятнице.
Это версия 1
Должны быть все документы (страницы сайта).
Каждый документ должен быть сделан на 1%
Минимум информации в версии 1:
есть все заголовки 2 и 3 уровня
под каждым заголовком есть минимум один абзац текста
из текст а под заголовками должно быть понятно, что там будет далее
текст может быть только в виде ключевых слов
Каждую пятницу возникает новая версия проекта.
Требования к новым документам в новой версии те же самые, что и к версии 1.
Документы, которые появились в предыдущей версии должны быть доработаны.
Уровень доработки: до связного текста под каждым заголовком.
Если что-то утверждаете, то укажите ссылку на информацию.
Кто выяснил, и описание.
Все обсуждения в комментарии!
Если есть замечания и комментарии к странице - для этого есть специальное место внизу каждой страницы.
Если вопросов много и они сложные - есть форум для проекта на главной странице проекта.
Тогда можно отвечать нормально.
В начало текста копируете текст со страницы.
Потом пишете свои замечания и соображения.
В одном комментарии - одна тема.
Не валите все в один комментарий. Это невозможно технически (ограничение по количеству символов).
На странице размещаем готовые варианты.
Если что-то вы считаете неправильным, или знаете, почему что-то может не получиться - смело присылайте свои мнения.
Формат сообщения:
Мое мнение касается информации
(копируете сюда адрес ссылки).
Информация
(указать какая)
неправильная, потому что
(указать причину, желательно со ссылками на источники).
Действие
(указать какое)
- не получиться сделать, потому что
(указать причину, желательно со ссылками на источники).
Мое предложение, как иначе решить эту проблему такое:
(тут написать свое предложение, как решить эту проблему, как исправить информацию).
Если нет варианта решения - то ваше мнение не интересно.
Если не указаны источники вашего мнения - то ваше мнение не интересно.
Цветовые схемы делают текст нечитабельным.
Поэтому минимально используйте выделение цветом или шрифтом.