Update documentation: sync material settings terminology and other improvements

Author: parashivbrl

docs/compatibility_and_workarounds.md

@@ -6,7 +6,7 @@ This document covers assets that work well with the glTF/GLB Importer for Maya a
 
 ---
 
-## ✅ What Works Well
+## What Works Well
 
 - **Khronos Sample Assets**: Most sample assets from the official [Khronos glTF Sample Assets repository](https://github.com/KhronosGroup/glTF-Sample-Assets) import properly without any issues when testing the plugin
 - **Standard glTF 2.0 Assets**: Files exported using proper glTF exporters that follow Khronos specifications
@@ -19,7 +19,7 @@ This document covers assets that work well with the glTF/GLB Importer for Maya a
 
 ---
 
-## 💡 Recommended Workarounds
+## Recommended Workarounds
 
 ### For Sketchfab Assets with Rigged Animations
 To properly import Sketchfab assets with rigged animations, use this Blender preprocessing workflow:
@@ -55,7 +55,7 @@ To properly import Sketchfab assets with rigged animations, use this Blender pre
 
 ---
 
-## 🔄 Round-trip Workflow: Re-exporting Imported Assets
+## Round-trip Workflow: Re-exporting Imported Assets
 
 When importing glTF/GLB files and then wanting to export them again using the Babylon exporter, several compatibility issues arise:
 
@@ -103,7 +103,7 @@ If your asset has animation clips and you need to re-export, follow these steps:
 
 ---
 
-## 🔧 Troubleshooting Tips
+## Troubleshooting Tips
 
 ### Asset Source Recommendations
 - **Recommended**: Use assets from the [Khronos Sample Assets repository](https://github.com/KhronosGroup/glTF-Sample-Assets) for testing
@@ -119,7 +119,7 @@ If your asset has animation clips and you need to re-export, follow these steps:
 
 ---
 
-## 📚 Additional Resources
+## Additional Resources
 
 - [Khronos glTF Sample Assets](https://github.com/KhronosGroup/glTF-Sample-Assets) - Official test assets
 - [glTF Validator](https://github.khronos.org/glTF-Validator/) - Online validation tool

docs/dependencies_installation.md

@@ -4,7 +4,7 @@ This guide will help you install the required dependencies for the glTF/GLB impo
 
 ---
 
-## 📋 System Requirements
+## System Requirements
 
 | Requirement | Details |
 |-------------|---------|
@@ -14,26 +14,27 @@ This guide will help you install the required dependencies for the glTF/GLB impo
 
 ---
 
-## 📦 Required Dependencies
+## Required Dependencies
 
 The plugin requires the following Python packages:
 
 - **[pygltflib](https://pypi.org/project/pygltflib/)** - Core library for glTF/GLB file handling
+- **[DracoPy](https://pypi.org/project/DracoPy/)** - Required for Draco mesh compression support
 - **[numpy](https://pypi.org/project/numpy/)** - Required for Maya 2024 and earlier versions only
 
-> **Note:** Maya 2025+ includes numpy by default, so you only need to install pygltflib.
+> **Note:** Maya 2025+ includes numpy by default, so you only need to install pygltflib and DracoPy.
 
 ---
 
-## 🚀 Installation Instructions
+## Installation Instructions
 
 ### Before You Start
 
-⚠️ **Important:** Close all instances of Maya before proceeding with the installation.
+**Important:** Close all instances of Maya before proceeding with the installation.
 
 ---
 
-### 🪟 Windows Installation
+### Windows Installation
 
 1. **Open Command Prompt as Administrator**
    - Press `Win + X` and select "Command Prompt (Admin)" or "Windows PowerShell (Admin)"
@@ -53,14 +54,19 @@ The plugin requires the following Python packages:
    mayapy -m pip install pygltflib
    ```
 
-4. **Install numpy (Maya 2024 and earlier only)**
+4. **Install DracoPy**
+   ```
+   mayapy -m pip install DracoPy
+   ```
+
+5. **Install numpy (Maya 2024 and earlier only)**
    ```
    mayapy -m pip install numpy
    ```
 
 ---
 
-### 🍎 macOS Installation
+### macOS Installation
 
 1. **Open Terminal**
    - Press `Cmd + Space`, type "Terminal", and press Enter
@@ -80,14 +86,19 @@ The plugin requires the following Python packages:
    ./mayapy -m pip install pygltflib
    ```
 
-4. **Install numpy (Maya 2024 and earlier only)**
+4. **Install DracoPy**
+   ```
+   ./mayapy -m pip install DracoPy
+   ```
+
+5. **Install numpy (Maya 2024 and earlier only)**
    ```
    ./mayapy -m pip install numpy
    ```
 
 ---
 
-### 🐧 Linux Installation
+### Linux Installation
 
 1. **Open Terminal**
    - Use your preferred method to open a terminal
@@ -107,14 +118,19 @@ The plugin requires the following Python packages:
    sudo ./mayapy -m pip install pygltflib
    ```
 
-4. **Install numpy (Maya 2024 and earlier only)**
+4. **Install DracoPy (may require sudo)**
+   ```
+   sudo ./mayapy -m pip install DracoPy
+   ```
+
+5. **Install numpy (Maya 2024 and earlier only)**
    ```
    sudo ./mayapy -m pip install numpy
    ```
 
 ---
 
-## ✅ Verifying Installation
+## Verifying Installation
 
 After installation, you can verify that the dependencies are properly installed:
 
@@ -124,26 +140,33 @@ After installation, you can verify that the dependencies are properly installed:
    ```python
    try:
        import pygltflib
-       print("✅ pygltflib successfully imported")
+       print("[SUCCESS] pygltflib successfully imported")
+   except ImportError:
+       print("[ERROR] pygltflib not found")
+   
+   try:
+       import DracoPy
+       print("[SUCCESS] DracoPy successfully imported")
    except ImportError:
-       print("❌ pygltflib not found")
+       print("[ERROR] DracoPy not found")
 
    try:
        import numpy
-       print("✅ numpy successfully imported")
+       print("[SUCCESS] numpy successfully imported")
    except ImportError:
-       print("❌ numpy not found")
+       print("[ERROR] numpy not found")
    ```
-You should see the following two lines in the script editor's output:
+You should see the following three lines in the script editor's output:
 ```
-✅ pygltflib successfully imported
-✅ numpy successfully imported
+[SUCCESS] pygltflib successfully imported
+[SUCCESS] DracoPy successfully imported
+[SUCCESS] numpy successfully imported
 ```
 
 ---
 
 
-## 🔧 Troubleshooting
+## Troubleshooting
 
 ### Common Issues
 

docs/file_type_specific_options.md

@@ -6,21 +6,21 @@ The right side of the import dialog contains various import settings organized i
 
 ## File Type Specific Options
 
-### 🎨 Material Settings
+### Material Settings
 
 - **Shader Type**: Set to **"Standard Surface"** (default)
 - **Shading Option**: Set to **"Use Normal Data"** (default)
 
 ---
 
-### 📐 Geometry Options
+### Geometry Options
 
 - **No merging**: Keeps geometry separate (default option)
 - **Merge Vertices**: Combines duplicate vertices  
 
 ---
 
-### 🖼️ Image Extraction
+### Image Extraction
 
 - **Use Relative Path**: Extracts images using relative path
 - **Default Location**: Images will be extracted to the project directory/source images by default
@@ -31,31 +31,31 @@ The right side of the import dialog contains various import settings organized i
 
 ---
 
-### 🎬 Animation Settings
+### Animation Settings
 
 - **Open Time Editor Window**: Opens the Time Editor for animation playback and editing when enabled
 
 ---
 
 ## Common to All File Types
 
-### ⚙️ General Options
+### General Options
 
 - **Group**: Groups imported objects together
 - **Remove duplicate shading networks**: Removes redundant material connections
 - **Merge Base Animation Layers**: Combines animation layers during import
 
 ---
 
-### 🔗 Referencing Options
+### Referencing Options
 
 - **Preserve references**: Maintains reference relationships
 - **Load Settings**: Choose how to handle saved reference load states
 - **Reserve unloaded namespaces**: Keeps namespace reservations
 
 ---
 
-### ▶️ Playback Options
+### Playback Options
 
 - **Always Override if Scene is Empty**: Automatically overrides playback settings in empty scenes
 - **Framerate Import**: Options for handling frame rate differences

docs/img/gltf_maya_icon.png

@@ -37,7 +37,7 @@ The Import dialog will open, providing you with several options and settings for
 
 ---
 
-## 💡 Tips & Best Practices
+## Tips & Best Practices
 
 - **File Format Support**: The importer supports both `.gltf` and `.glb` file formats
 - **Default Settings**: Most default settings work well for standard imports, but you can customize them based on your specific workflow requirements  

docs/img/image_home.png

@@ -10,17 +10,17 @@ This plugin unlocks access to the vast ecosystem of optimized 3D content from we
 
 ---
 
-## ✨ Key Features
+## Key Features
 
-- **📁 File Format Support**: Import both `.gltf` and `.glb` file formats
-- **🎯 Asset Import**: Support for meshes, materials, textures, animations, and more
-- **🎨 Material System**: PBR material conversion to Maya's native material system  
-- **🎬 Animation Support**: Import skeletal animations and morph targets
-- **🔧 Extension Compatibility**: Support for common Khronos extensions and selected vendor extensions
+- **File Format Support**: Import both `.gltf` and `.glb` file formats
+- **Asset Import**: Support for meshes, materials, textures, animations, and more
+- **Material System**: PBR material conversion to Maya's native material system  
+- **Animation Support**: Import skeletal animations and morph targets
+- **Extension Compatibility**: Support for common Khronos extensions and selected vendor extensions
 
 ---
 
-## 🚀 Quick Start Guide
+## Quick Start Guide
 
 1. **[Install Dependencies](dependencies_installation.md)** - Set up required Python packages
 2. **[Install Plugin](plugin_installation.md)** - Add the plugin to your Maya installation  
@@ -29,12 +29,6 @@ This plugin unlocks access to the vast ecosystem of optimized 3D content from we
 
 ---
 
-## 💡 Why Choose This Plugin?
-
-Transform your Maya workflow with industry-standard 3D content import capabilities. Whether you're working with web-based 3D assets, game engine exports, or modern creation tool outputs, this plugin ensures seamless integration into your Maya projects.
-
----
-
 ## Trademarks
 
 - **Maya** is a registered trademark of Autodesk, Inc.

docs/importing_gltf_glb_file.md

@@ -4,11 +4,11 @@
 
 While the glTF/GLB Importer for Maya successfully handles most files that adhere to the [Khronos glTF 2.0 specifications](https://www.khronos.org/gltf/), there are several known limitations and specific issues that users should be aware of.
 
-> 💡 **For information about compatible assets and workarounds, see the [Asset Compatibility and Workarounds](compatibility_and_workarounds.md) guide.**
+> **Note:** For information about compatible assets and workarounds, see the [Asset Compatibility and Workarounds](compatibility_and_workarounds.md) guide.
 
 ---
 
-## ⚠️ Sketchfab Asset Import Issues
+## Sketchfab Asset Import Issues
 
 Sketchfab assets, particularly those that are **automatically generated**, present specific challenges:
 
@@ -29,7 +29,7 @@ Sketchfab assets, particularly those that are **automatically generated**, prese
 
 ---
 
-## 🔧 General Plugin Limitations
+## General Plugin Limitations
 
 ### File Format Constraints
 - **glTF Extensions**: Not all Khronos extensions are fully supported
@@ -52,7 +52,7 @@ Sketchfab assets, particularly those that are **automatically generated**, prese
 
 ---
 
-## 📋 Reporting Issues
+## Reporting Issues
 
 If you encounter limitations not listed here, please provide:
 

docs/index.md

@@ -52,15 +52,15 @@ Controls how normals and shading are handled during import:
 
 - Maintains the intended shading as authored in the original model
 
-**Harden edges**
+**Hard edge**
 
 - Converts to Maya's hard edge shading
 
 - Creates sharp edges between faces
 
 - Useful for mechanical or architectural models
 
-**Soften edges**
+**Soften edge**
 
 - Applies Maya's soft edge shading
 

docs/limitations.md

@@ -23,4 +23,4 @@ Material variants enable artists and designers to quickly experiment with differ
 
 ## Important Note
 
-⚠️ **Warning**: Avoid using "Delete Unused Nodes" from the Hypershade's Edit dropdown menu when working with material variants. This operation will delete materials that are not currently assigned to geometry, which includes the alternative materials used by other variants. If unused materials are deleted, switching between material variants will not work properly as the required materials will no longer be available in the scene.
+**Warning**: Avoid using "Delete Unused Nodes" from the Hypershade's Edit dropdown menu when working with material variants. This operation will delete materials that are not currently assigned to geometry, which includes the alternative materials used by other variants. If unused materials are deleted, switching between material variants will not work properly as the required materials will no longer be available in the scene.