[Story] Create project to build, lint, test the monorepo docs site

tschaffter commented 7 months ago

What product(s) is this story for?

Sage Monorepo

As a user, I want

As a Developer, I want to use the monorepo (Nx) API to develop the docs site so that I can focus on creating docs content.

Description

Notes:

Create a Python project in apps/sage-monorepo/docs
For the serve task, refer to the instruction given by @vpchung here.

Acceptance criteria

No response

Tasks

No response

Anything else?

No response

Have you linked this story to a GitHub Project?

[X] I have linked this story to a GitHub Project and set its metadata.

tschaffter commented 7 months ago

mkdocs serve
ERROR   -  Config value 'plugins': The "mkdocstrings" plugin is not installed

Aborted with 1 configuration errors!

vpchung commented 7 months ago

ERROR - Config value 'plugins': The "mkdocstrings" plugin is not installed

Whoops! I thought I had removed the plug-in from the configuration file (I didn't 😅 ). If you think we will use it, I will add it to the instructions so that local development is seamless.

tschaffter commented 7 months ago

The extension will be removed in #2528

Sage-Bionetworks / sage-monorepo