Create book categorization functionality (#30) · Issues · Documentation / docs-publisher

Create book categorization functionality

Created by: seanmadsen

I would like for civicrm-docs to be capable of hosting extension-specific books eventually. I can imagine a day when there are a handful of books core-related books (e.g. User, Admin, Dev), plus over a dozen extension-specific books. When this day comes, having a docs home page that separates core-related books from extension-specific books will make the home page easier to navigate.

I propose the following is added to a book's .yml config file:

category: core

category: extension

If this setting is missing, then the app would assume "extension".

After these categories are in place, the home page can be modified to display books separately by category.

Why do this now, when there are zero extension-specific books? — I think that if we can get one extension-specific book in there and make the home page look really slick and well-organized, it will help motivate other extensions maintainers to set up their own docs in books.

*Created by: seanmadsen*

I propose the following is added to a book's `.yml` config file:

```yaml
category: core
```

```yaml
category: extension
```

If this setting is missing, then the app would assume "extension".

After these categories are in place, the home page can be modified to display books separately by category.

Why do this now, when there are zero extension-specific books? &mdash; I think that if we can get *one* extension-specific book in there and make the home page look really slick and well-organized, it will help motivate other extensions maintainers to set up their own docs in books.

Discussion
Designs

The one place for your designs

To enable design management, you'll need to meet the requirements. If you need help, reach out to our support team for assistance.