Merge pull request #80 from serenity-js/docs/handbook-cleanup

docs(handbook): revised and extended the Serenity/JS Handbook

Author: jan-molak

README.md

@@ -13,10 +13,10 @@
 of complex software systems faster, more collaborative and easier to scale.
 
 ⭐️ Get started with Serenity/JS!
-- [Serenity/JS web testing tutorial](https://serenity-js.org/handbook/web-testing/your-first-web-scenario)
-- [Serenity/JS Handbook](https://serenity-js.org/handbook) and [Getting Started guides](https://serenity-js.org/handbook/getting-started/)
-- [API documentation](https://serenity-js.org/api/core)
-- [Serenity/JS Project Templates on GitHub](https://serenity-js.org/handbook/getting-started/project-templates/)
+- [Serenity/JS Tutorial](https://serenity-js.org/handbook/tutorials/)
+- [Serenity/JS Handbook](https://serenity-js.org/handbook/)
+- [API documentation](https://serenity-js.org/api/)
+- [Serenity/JS Project Templates on GitHub](https://serenity-js.org/handbook/project-templates/)
 
 👋 Join the Serenity/JS Community!
 - Meet other Serenity/JS developers and maintainers on the [Serenity/JS Community chat channel](https://matrix.to/#/#serenity-js:gitter.im)
@@ -54,7 +54,7 @@ when you open the workspace, so you can start working on the Serenity/JS website
 To work on the Serenity/JS website locally, you'll need to:
 - [Fork](https://help.github.com/en/github/getting-started-with-github/fork-a-repo) this repository to your GitHub account
 - [Clone](https://help.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) your fork to your machine
-- Make sure you have the have [Node.js](https://nodejs.org/) installed on your machine, as per the general [Serenity/JS installation instructions](https://serenity-js.org/handbook/getting-started/installation/#installing-nodejs)
+- Make sure you have [Node.js](https://nodejs.org/) installed on your machine, as per the general [Serenity/JS installation instructions](https://serenity-js.org/handbook/installation/)
 - Install the Node.js dependencies by running `npm ci` in the project root
 - Make sure you can build the Serenity/JS website on your machine by running `npm run build`
 - Start the local development server by running `npm start`

docusaurus.config.ts

@@ -71,6 +71,10 @@ const config: Config = {
             high-quality, business-focused test scenarios that interact with any interface of your system
             and produce comprehensive test reports that build trust between delivery teams and the business.
             `,
+        banner: {
+            text: 'New Playwright Test guide is out!',
+            link: '/handbook/test-runners/playwright-test',
+        }
     },
 
     url: 'https://serenity-js.org',
@@ -103,6 +107,12 @@ const config: Config = {
                     sidebarPath: './src/sidebars/handbook.ts',
                     showLastUpdateAuthor: false,
                     showLastUpdateTime: true,
+                    async sidebarItemsGenerator({defaultSidebarItemsGenerator, ...args}) {
+                        const sidebarItems = await defaultSidebarItemsGenerator(args);
+                        // DEBUG sidebar items
+                        // console.log({ sidebarItems })
+                        return sidebarItems.filter(item => ! item.id.endsWith('index'));
+                    },
                 },
                 blog: {
                     ...remarkOptions,
@@ -125,7 +135,6 @@ const config: Config = {
     ],
 
     themeConfig: {
-        // Replace with your project's social card
         image: 'images/serenity-js-social-card.jpg',    // open graph
         colorMode: {
             disableSwitch: false,
@@ -186,11 +195,11 @@ const config: Config = {
                     title: 'Handbook',
                     items: [
                         { label: 'Why Serenity/JS', to: '/handbook/' },
-                        { label: 'Getting started', to: '/handbook/getting-started' },
-                        { label: 'Web testing', to: '/handbook/web-testing' },
-                        { label: 'API testing', to: '/handbook/api-testing' },
-                        { label: 'Mobile testing', to: '/handbook/mobile-testing' },
+                        { label: 'Tutorials', to: '/handbook/tutorials' },
                         { label: 'Core Design Patterns', to: '/handbook/design' },
+                        { label: 'Web Testing', to: '/handbook/web-testing' },
+                        { label: 'API Testing', to: '/handbook/api-testing' },
+                        { label: 'Mobile Testing', to: '/handbook/mobile-testing' },
                         { label: 'Reporting', to: '/handbook/reporting' },
                         { label: 'Test runners', to: '/handbook/test-runners' },
                         { label: 'Integration', to: '/handbook/integration' },