Title: Redesigned Contributor Handbooks Author: Samuel Sidler Published: April 24, 2014 --- [ ](https://profiles.wordpress.org/samuelsidler/) [Samuel Sidler](https://profiles.wordpress.org/samuelsidler/) 12:07 am _on_ April 24, 2014 Tags: [handbooks ( 44 )](https://make.wordpress.org/docs/tag/handbooks/) # Redesigned Contributor Handbooks Hello Docs Team! I just landed a new design for the contributor handbooks, courtesy [@sonjanyc](https://profiles.wordpress.org/sonjanyc/)( [mockup is here](https://meta.trac.wordpress.org/attachment/ticket/430/polyglot-handbook-mock-4b.jpg)). You can see them on the [core](https://make.wordpress.org/core/handbook/), [mobile](https://make.wordpress.org/mobile/handbook/), [docs](https://make.wordpress.org/docs/handbook/), and [polyglot](https://make.wordpress.org/polyglots/handbook/) handbooks, among others. The design is still a little rough around the edges, but the bulk of it is there. Namely, here’s some issues I’ve noticed: * There’s a hover for headings in chapters box * Content doesn’t properly wrap around the “topics” box * We need to add a handbook name to each handbook, along with a design ([#439](https://meta.trac.wordpress.org/ticket/439)) * The “Watch this page” widgetWidget A WordPress Widget is a small block that performs a specific function. You can add these widgets in sidebars also known as widget- ready areas on your web page. WordPress widgets were originally created to provide a simple and easy-to-use way of giving design and structure control of the WordPress theme to the user. needs to move to be in the actions bar ([#437](https://meta.trac.wordpress.org/ticket/437)) * In the polyglots handbook, for admins, “Flag Unresolved” is shown ([#436](https://meta.trac.wordpress.org/ticket/436)) Last but not least, I need a decision from y’all. Currently, we list all hierarchal subpages on the page they’re from. For example, in the coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. handbook, on [the Coding Standards page](https://make.wordpress.org/core/handbook/coding-standards/), we show the subpages as a (undesigned) list. The decision we need made is whether to keep that list and design it or to remove the list entirely. Keep in mind the Chapters sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme. can be organized however you’d like; it doesn’t need to be hierarchal. If we remove the Pages list, we’ll need to make sure the content is properly linked within the page. What say you? ---   Other things I should mention are that we should document these things somewhere: * The starting headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. tag in any page should be an

to keep the topics box designed. (I went through and fixed this on the core and mobile handbooks.) * The Chapters sidebar is a custom menu and can be organized however you like. * Currently, the headings in the Chapters sidebar are merely re-styled tags with # as the href. We’ll probably be changing this, however. Finally, please note that this design is only for the _contributor_ handbooks. The developer handbooks will have a style that matches devhub. [#handbooks](https://make.wordpress.org/docs/tag/handbooks/) ### Share this: * [ Threads ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=threads) * [ Mastodon ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=mastodon) * [ Bluesky ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=bluesky) * [ X ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=x) * [ Facebook ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=facebook) * [ LinkedIn ](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?share=linkedin) * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2014%2F04%2F24%2Fredesigned-contributor-handbooks%2F%23respond&locale=en_US) 1. ![](https://secure.gravatar.com/avatar/8bf29c777c4a386cb938cb3afc6fa6398259c5d31103b9704f75feba84b6b385? s=32&d=mm&r=g) 2. [Kim Parsell](https://profiles.wordpress.org/kpdesign/) 12:22 am _on_ April 24, 2014 3. My vote is to remove the Pages section at the top. With the old theme, I found them confusing with the Table of Contents section right below them. With the redesigned Chapters menu and the Topics box in the upper right, I think we can now remove the Pages section entirely. 4. With hook docs done, I’m available to help with any of the design changes needed. 5. Thanks [@sonjanyc](https://profiles.wordpress.org/sonjanyc/) for the awesome new theme. 🙂 6. * ![](https://secure.gravatar.com/avatar/479f05d4acc73915a43b24a1ee3f30477d4ee19bbec6a5a79906d396f2b2d2ad? s=32&d=mm&r=g) * [samuelsidler](https://profiles.wordpress.org/samuelsidler/) 5:09 am _on_ April 24, 2014 * I agree, but wanted to get feedback first. Can you bring it up at the docs chat tomorrow? I probably won’t be able to attend. - ![](https://secure.gravatar.com/avatar/8bf29c777c4a386cb938cb3afc6fa6398259c5d31103b9704f75feba84b6b385? s=32&d=mm&r=g) - [Kim Parsell](https://profiles.wordpress.org/kpdesign/) 9:30 am _on_ April 24, 2014 - I’ll add it to the agenda for the chat this evening. 7. ![](https://secure.gravatar.com/avatar/776730d4c9623901b3d6e8170da05ea095688bc3857724a18ef767ed2ff35e8f? s=32&d=mm&r=g) 8. [David Laietta](https://profiles.wordpress.org/davidjlaietta/) 1:24 pm _on_ April 24, 2014 9. I agree on removing the pages, having them linked in the sidebarSidebar A sidebar in WordPress is referred to a widget-ready area used by WordPress themes to display information that is not a part of the main content. It is not always a vertical column on the side. It can be a horizontal rectangle below or above the content area, footer, header, or any where in the theme.. It makes more sense to me in terms of confusion and being able to find everything that I want in one place ( the sidebar). ### Leave a Reply 󠀁[Cancel reply](https://make.wordpress.org/docs/2014/04/24/redesigned-contributor-handbooks/?output_format=md#respond)󠁿 You must be [logged in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fdocs%2F2014%2F04%2F24%2Fredesigned-contributor-handbooks%2F&locale=en_US) to post a comment. # Post navigation [← Admin Help – User Personas](https://make.wordpress.org/docs/2014/04/21/admin-help-user-personas/) [WordPress Contributor Experience Survey →](https://make.wordpress.org/docs/2014/04/25/wordpress-contributor-experience-survey/)