В чем разница между User Guide и How-to Guide? На первый взгляд кажется, что особой разницы нет. Оба этих типа документации в той или иной мере содержат пошаговое объяснение того, какие шаги нужно выполнить дабы достичь определенной цели. Таким образом, и в User Guide и в How-to Guide почти наверняка будет последовательное описание действий, необходимых для выполнения той или иной пользовательской задачи. Что же тогда их отличает? Расскажу, как эту разницу понимаю я😺 Начнем с того, что у этих документов разная целевая аудитория. User Guide нужен для того, чтобы условному новичку вообще рассказать о том, что из себя представляет объект описания. А вот How-to Guide помогает уже опытному пользователю с решением конкретной задачи в рамках объекта описания. Давайте посмотрим на примере youtube, чтобы было понятнее)) Представим, что есть человек, который вообще никогда не пользовался youtube. User Guide расскажет что такое ютуб, для чего он нужен, что там размещается, как там работает функция поиска, на что и куда нужно нажать, чтобы посмотреть видео и тд. В то же время How-to Guide может помочь пользователю, который уже знаком с площадкой youtube, узнать, например, как выставлять в видео тайм коды, как загрузить свое видео, как настроить монетизацию (когда-то это было актуально) и тд. Краткий итог такой: User Guide нужен для новичков, чтобы те могли узнать, что из себя представляет тот или иной сервис и как начать с ним работу, а How-to Guide объясняет уже опытным пользователям как решить некоторые специфические задачи с помощью этого сервиса. В общем, сначала нужно понять, что 2x2=4, прежде чем решать квадратное уравнение) А как вы понимаете разницу между этими двумя типами документации? Пишите в комменты 🙂
User Story — это формат описания требований к продукту, который является основой Agile-методологий. Он помогает команде разработки продукта понимать цели и потребности пользователей, а также конкретизировать задачи для выполнения в рамках итерации продукта (спринта, релиза). В данной статье мы рассмотрим основы и принципы написания User Story. Основы User Story Структура User Story представляет собой короткую и ясную историю, которая описывает потребность пользователя в продукте. Она состоит из трех...