admin: Rename the repo's top level doc/ subdir to docs/

Mostly for conformance with OpenImageIO, since we share so many
scripts and management docmentation. But looking across ASWF project,
they almost all use "docs/" (OSL and OpenVDB were the only outliers).

Signed-off-by: Larry Gritz <lg@larrygritz.com>

Author: lgritz

.github/PULL_REQUEST_TEMPLATE.md

@@ -30,7 +30,7 @@ instructions!
 <!-- Put an 'x' in the boxes as you complete the checklist items -->
 
 - [ ] **I have read the guidelines** on [contributions](https://github.com/AcademySoftwareFoundation/OpenShadingLanguage/blob/main/CONTRIBUTING.md) and [code review procedures](https://github.com/AcademySoftwareFoundation/OpenShadingLanguage/blob/main/docs/dev/CodeReview.md).
-- [ ] **I have read the [Policy on AI Coding Assistants](https://github.com/AcademySoftwareFoundation/OpenShadingLanguage/blob/main/doc/dev/AI_Policy.md)**
+- [ ] **I have read the [Policy on AI Coding Assistants](https://github.com/AcademySoftwareFoundation/OpenShadingLanguage/blob/main/docs/dev/AI_Policy.md)**
   and if I used AI coding assistants, I have an `Assisted-by: TOOL / MODEL`
   line in the pull request description above.
 - [ ] **I have updated the documentation** if my PR adds features or changes

.github/workflows/ci.yml

@@ -18,14 +18,14 @@ on:
       - '!**/analysis.yml'
       - '!**/docs.yml'
       - '!**.properties'
-      - '!doc/**'
+      - '!docs/**'
   pull_request:
     paths:
       - '**'
       - '!**.md'
       - '!**.rst'
       - '!**.tex'
-      - '!doc/**'
+      - '!docs/**'
   schedule:
     # Full nightly build, for the main project repo (not for forks)
     - cron: "0 6 * * *"

CONTRIBUTING.md

@@ -271,7 +271,7 @@ first try is not accepted. It happens to all of us.
 8. After approval, one of the senior developers (with commit approval to the
 official main repository) will merge your fixes into the main branch.
 
-Please see the [Code Review](doc/dev/CodeReview.md) document for more
+Please see the [Code Review](docs/dev/CodeReview.md) document for more
 explanaton of the code review process.
 
 

README.md

@@ -527,13 +527,13 @@ mechanism.
 
 * [CONTRIBUTING](CONTRIBUTING.md) has detailed instructions about the
   development process.
-* [AI Policy](doc/dev/AI_Policy.md) decribes our policies on AI coding
+* [AI Policy](docs/dev/AI_Policy.md) decribes our policies on AI coding
   assistance tools.
-* [RELEASING](doc/dev/RELEASING.md) explains our policies and procedures for
+* [RELEASING](docs/dev/RELEASING.md) explains our policies and procedures for
   making releases. We have a major, possibly-compatibility-breaking, release
   annually in September/October, and minor bug fix and safe feature addition
   release at the beginning of every month.
-* Other developer documentation is in the [doc/dev](doc/dev) directory.
+* Other developer documentation is in the [docs/dev](docs/dev) directory.
 * You may also have luck learning a bit about the organization and
   architecture of the project by reading the [DeepWiki Analysis of
   OpenShadingLanguage](https://deepwiki.com/AcademySoftwareFoundation/OpenShadingLanguage).

doc/README.md docs/README.mddoc/README.md renamed to docs/README.md

@@ -16,6 +16,6 @@ Method #1:
 https://github.com/debaetsd/OSL_build
 
 Method #2:
-Go through `doc/build_install/windows/Readme.md` and using batch files to install OSL cleanly!
+Go through `docs/build_install/windows/Readme.md` and using batch files to install OSL cleanly!
 
 ## macOS

…pp_integration/OptiX-Inlining-Options.md …pp_integration/OptiX-Inlining-Options.mddoc/app_integration/OptiX-Inlining-Options.md renamed to docs/app_integration/OptiX-Inlining-Options.md doc/app_integration/OptiX-Inlining-Options.md renamed to docs/app_integration/OptiX-Inlining-Options.md

@@ -104,7 +104,7 @@ so I studied its python build script and found we can use same logic for install
 It still needs some other works to make it complete for all dependencies (optional).
 
 We will keep Pixar name on it as inspiration code (or we can keep their copyright)
-You can Run the installer from: `yourpath/OpenShadingLanguage/doc/build_install/windows/build_osl.bat`
+You can Run the installer from: `yourpath/OpenShadingLanguage/docs/build_install/windows/build_osl.bat`
 
 ---
 
@@ -144,11 +144,11 @@ For running batch scripts without any problem I recommend to create some base en
 
 |
 
-Open `doc/build_install/windows/osl_env_vars_setup.bat` in your editor and edit paths' values based on your installation folders.
+Open `docs/build_install/windows/osl_env_vars_setup.bat` in your editor and edit paths' values based on your installation folders.
 
 ### **2.3 Set Flags based on your needs**
 
-The main build launcher is here `doc/build_install/windows/build_osl.bat`
+The main build launcher is here `docs/build_install/windows/build_osl.bat`
 
 For now we can not assign pre-installed llvm so we have to build all together at once and put all of them in one directory.
 
@@ -196,7 +196,7 @@ Based on Environment Variables you set in previous sections you can just call th
 **My Method:**
 
 - Open Powershell
-- Go to: yourPath/OpenShadingLanguage/doc/build_install/windows
+- Go to: yourPath/OpenShadingLanguage/docs/build_install/windows
 - Run build_osl.bat release
 
 ### **3.1 Running the code based on your config**
@@ -295,7 +295,7 @@ That's it
 TIP: this process is getting better, I will update the document soon
 
 **Conclusion:**
-For easy installation you just need to setup your Environment Variables in `yourPath/OpenShadingLanguage/doc/build_install/windows/osl_env_vars_setup.bat` based on your paths
+For easy installation you just need to setup your Environment Variables in `yourPath/OpenShadingLanguage/docs/build_install/windows/osl_env_vars_setup.bat` based on your paths
 
 It is a custom setup, for example all dependencies are built before osl, because I had lots of issues on using external installation (like llvm)
 and I tried this method on llvm 7, 8 and 9, all with error, so my current build setup is on llvm 11 and C++14, it can be changed in code. (I am trying to make it easy to use for changing configs with arguments)