-
Notifications
You must be signed in to change notification settings - Fork 45
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Splitting existing pages into multiple pages #211
Comments
On the OI-Dev mailing list @cstes mentioned the OI handbook is based on the FreeBSD handbook. This is a breakdown of the existing high level sections in each of the 5 pages which make up the OI handbook:
The FreeBSD has a page for each chapter (plus appendix) as below:
The OI handbook has much less content than the FreeBSD handbook, so it wouldn't make sense to split everything down to the same level. I think it would be best to split the 4 main pages into 2-4 sub pages/chapters and to use the 'Part/Chapter' terminology. This reorganization would be a good opportunity to consolidate a few areas of duplication. It may be worth investigating if the webpage navigation for the handbook can also be made to be more like FreeBSD - this is more suitable for this content than the existing drop down menubar. |
The Getting Started and Systems Administration pages have a lot of content packed into a single page. This doesn't seem like the best way to organise things.
In particular there is still content on ZFS and Virtualization that could be migrated from the old Wiki. There are placeholders in the docs where this could go, but it would make the pages even longer.
It seems like the content could be split across a few more pages, so that storage and zones/virtualization could have their own pages.
The text was updated successfully, but these errors were encountered: