docs refactor: rename doc to docs, and adopt a docs/source folder

Author: consideRatio

.github/workflows/publish.yml

@@ -5,15 +5,15 @@ on:
     paths-ignore:
       - "**.md"
       - "**.rst"
-      - "doc/**"
+      - "docs/**"
       - "examples/**"
       - ".github/workflows/**"
       - "!.github/workflows/publish.yml"
   push:
     paths-ignore:
       - "**.md"
       - "**.rst"
-      - "doc/**"
+      - "docs/**"
       - "examples/**"
       - ".github/workflows/**"
       - "!.github/workflows/publish.yml"

.github/workflows/test.yml

@@ -8,15 +8,15 @@ on:
     paths-ignore:
       - "**.md"
       - "**.rst"
-      - "doc/**"
+      - "docs/**"
       - "examples/**"
       - ".github/workflows/**"
       - "!.github/workflows/test.yml"
   push:
     paths-ignore:
       - "**.md"
       - "**.rst"
-      - "doc/**"
+      - "docs/**"
       - "examples/**"
       - ".github/workflows/**"
       - "!.github/workflows/test.yml"

.readthedocs.yaml

@@ -5,7 +5,7 @@
 version: 2
 
 sphinx:
-  configuration: doc/conf.py
+  configuration: docs/source/conf.py
 
 build:
   os: ubuntu-22.04
@@ -14,4 +14,4 @@ build:
 
 python:
   install:
-    - requirements: doc/requirements.txt
+    - requirements: docs/requirements.txt

CONTRIBUTING.md

@@ -5,7 +5,7 @@
 # from the environment for the first two.
 SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = .
+SOURCEDIR     = source
 BUILDDIR      = _build
 
 # Put it first so that "make" without argument is like "make help".

doc/contribute.md

@@ -7,7 +7,7 @@ REM Command file for Sphinx documentation
 if "%SPHINXBUILD%" == "" (
 	set SPHINXBUILD=sphinx-build
 )
-set SOURCEDIR=.
+set SOURCEDIR=source
 set BUILDDIR=_build
 
 if "%1" == "" goto help