>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #50464. --> >>> <p>By presenting a valuable feature of the Book Module as the defining one, the documentation in core (and in the Handbook) hides the module's power and makes the module seem limited in a way it is not. </p> <p>The core documentation says:</p> <p> A book is a collaborative writing effort: users can<br> collaborate writing the pages of the book, positioning the<br> pages in the right order, and reviewing or modifying pages<br> previously written. So when you have some information to<br> share or when you read a page of the book and you didn't<br> like it, or if you think a certain page could have been<br> written better, you can do something about it.</p> <p>My suggested revision:</p> <p> A book is a set of pages tied together in sequence, with<br> links and menus (automatically created) to guide users from<br> section to section or to the previous page or the next.<br> Users can collaborate in writing the book, reviewing or<br> modifying the pages, and putting them in the right order. So<br> when you have something to share, or you've read a page you<br> didn't like or you think could be better, you can do something<br> about it.</p> <p>Or, shorter (and therefore better):</p> <p> A book is a set of pages tied together in sequence, with<br> links and menus (automatically created) to guide users from<br> section to section or to the previous page or the next.<br> Users can collaborate in writing the book, reviewing or<br> modifying the pages, and putting them in the right order.</p> <p>A book may be collaborative but doesn't have to be. I can write a one-man book that no one else can modify. Or, for that matter, with the right permissions I can collaborate on a story or a page. The ability to allow or disallow limited or unlimited collaboration is a Drupal feature from top to bottom. (Put that last line in lights and send it to the marketing team.)</p> <p>When I first came upon Drupal I saw the "collaborative book module" touted as its outstanding feature-- but it seemed an odd one, and for my one-man site likely irrelevant. Perhaps for literary geeks experimenting with a multi-author novel?</p> <p>Both for informing and for marketing, the docs here deserve to be fixed.</p> <p>---------------------------------</p> <p>Going a bit further, here's what I'd do to the whole page:</p> <p><strong>Home</strong></p> <p><strong>create content</strong><br> Choose an item from the list:</p> <p><strong>book page</strong><br> A book is a set of pages tied together in sequence, with links and menus (automatically created) to guide users from section to section or to the previous page or the next. Users can collaborate in writing the book, reviewing or modifying the pages, and putting them in the right order.</p> <p><strong>page</strong><br> If you want to add a static page, like a contact page or an about page, use a page.</p> <p><strong>story</strong><br> Stories are articles in their simplest form. They have a title, a body, and (taken from the body) a teaser. You can also use stories for a blog or for news articles.</p>