Docs: fix minor UX issues (#42)

* develop:
  Docs: fix minor UX issues (#42)
  feat: add algolia search for docs and api ref (#39)

Author: heitorlessa

Diff for: Makefile

@@ -33,8 +33,9 @@ build-docs:
 	@$(MAKE) build-docs-website
 	@$(MAKE) build-docs-api
 
-build-docs-api: dev
-	poetry run pdoc --html --output-dir dist/api/ ./aws_lambda_powertools --force
+build-docs-api:
+	pip install pdoc3~=0.7.5
+	pdoc3 --html --output-dir dist/api/ ./aws_lambda_powertools --force
 	mv dist/api/aws_lambda_powertools/* dist/api/
 	rm -rf dist/api/aws_lambda_powertools
 

Diff for: docs/gatsby-config.js

@@ -1,11 +1,13 @@
+const docsWebsite = "https://awslabs.github.io/aws-lambda-powertools-python"
+
 module.exports = {
     pathPrefix: '/aws-lambda-powertools-python',
     siteMetadata: {
         title: 'AWS Lambda Powertools Python',
         description: 'A suite of utilities for AWS Lambda Functions that makes tracing with AWS X-Ray, structured logging and creating custom metrics asynchronously easier',
         author: `Amazon Web Services`,
         siteName: 'AWS Lambda Powertools Python',
-        siteUrl: 'https://awslabs.github.io/aws-lambda-powertools-python'
+        siteUrl: `${docsWebsite}`
     },
     plugins: [
         {
@@ -14,9 +16,10 @@ module.exports = {
                 root: __dirname,
                 menuTitle: 'Helpful resources',
                 githubRepo: 'awslabs/aws-lambda-powertools-python',
-                baseUrl: 'https://awslabs.github.io/aws-lambda-powertools-python',
+                baseUrl: `${docsWebsite}`,
                 algoliaApiKey: 'a8491b576861e819fd50d567134eb9ce',
                 algoliaIndexName: 'aws-lambda-powertools-python',
+                logoLink: `${docsWebsite}`,
                 sidebarCategories: {
                     null: [
                         'index'
@@ -69,7 +72,6 @@ module.exports = {
         },
         'gatsby-plugin-antd',
         'gatsby-remark-autolink-headers',
-        'gatsby-plugin-offline',
         'gatsby-plugin-sitemap'
     ]
 };