ci/cd: docs: configure environment
kamilsk opened this issue · comments
Motivation: provide a static site with documentation for better project representation.
Inventory
- https://docusaurus.io (too complex)
- https://mdxjs.com
- https://www.docz.site
- https://markdoc.dev
- https://nextjs.org (has benefits with integration with Vercel)
- Environment
# "scripts": {
# "docz:dev": "docz dev",
# "docz:build": "docz build",
# "docz:serve": "docz build && docz serve"
# },
# /go-module/docs/node_modules/.bin/gatsby
# "scripts": {
# "docusaurus": "docusaurus",
# "start": "docusaurus start",
# "build": "docusaurus build",
# "swizzle": "docusaurus swizzle",
# "deploy": "docusaurus deploy",
# "clear": "docusaurus clear",
# "serve": "docusaurus serve",
# "write-translations": "docusaurus write-translations",
# "write-heading-ids": "docusaurus write-heading-ids",
# "typecheck": "tsc"
# },
# "scripts": {
# "dev": "next dev",
# "build": "next build",
# "start": "next start",
# "lint": "next lint"
# },