Update developer-docs.md

Author: obenland

docs/developer-docs.md

@@ -5,7 +5,7 @@
 - [Extending the Settings Interface](#extending-the-settings-interface)
 - [JavaScript and CSS Development](#javascript-and-css-development)
   - [Block Development](#block-development)
-  - [Standalone Assets](#standalone-assets)
+  - [Feature-Based Asset Organization](#feature-based-asset-organization)
 - [Development Workflow](#development-workflow)
   - [Available Commands](#available-commands)
   - [Build Process](#build-process)
@@ -70,14 +70,14 @@ add_action( 'admin_enqueue_scripts', function( $hook ) {
 
 ### Block Development
 
-The ActivityPub plugin uses the WordPress Block Editor (Gutenberg) architecture for developing custom blocks. All block-related code is located in the `/src` directory.
+The ActivityPub plugin uses the WordPress Block Editor (Gutenberg) architecture for developing custom blocks. All block-related code is located in the `/src/blocks` directory.
 
 #### Block Structure
 
 Each block typically follows this directory structure:
 
 ```
-/src/block-name/
+/src/blocks/block-name/
 ├── block.json       # Block configuration.
 ├── edit.js          # Edit component.
 ├── index.js         # Block registration.
@@ -93,48 +93,62 @@ Each block typically follows this directory structure:
 4. **Accessibility**: Ensure your blocks are accessible to all users.
 5. **Indentation**: Use tabs for indentation in SCSS files, not spaces.
 
-### Standalone Assets
+### Feature-Based Asset Organization
 
-For non-block JavaScript and CSS files, the ActivityPub plugin uses the `/src` directory for source files, which are then built into the `/build` directory by `wp-scripts build`.
+The ActivityPub plugin organizes scripts and styles by feature rather than by file type. Each feature has its own directory containing all related assets.
 
 #### Structure
 
 ```
 /src/
-├── css/            # Source CSS files.
-├── js/             # Source JavaScript files.
-└── [block-name]/   # Block directories.
-
-/build/
-├── css/            # Built CSS files.
-└── js/             # Built JavaScript files.
+├── blocks/          # Block-specific code and styles
+│   ├── reply/       # Reply block
+│   └── ...          # Other blocks
+├── wp-admin/        # Admin-related features
+│   ├── admin.js     # Admin JavaScript
+│   ├── admin.scss   # Admin styles
+│   └── ...          # Other admin features
+├── feature-name/    # Any other feature
+│   ├── script.js    # Feature JavaScript
+│   ├── style.scss   # Feature styles
+│   └── ...          # Other feature files
+└── ...              # Other feature directories
+
+/build/              # Compiled assets, organized by feature
 ```
 
-#### Adding New JavaScript Files
+#### Adding New Feature Assets
 
-1. Create your JavaScript source file in the `/src/js/` directory:
+1. Create a new directory for your feature in the `/src/` directory:
    ```
-   /src/js/your-feature.js
+   /src/your-feature/
    ```
 
-2. When you run `npm run build`, WordPress Scripts will:
-   - Compile your JavaScript file to `/build/js/your-feature.js`.
-   - Generate an asset file at `/build/js/your-feature.asset.php` containing dependencies and version information.
+2. Add your JavaScript and/or SCSS files to this directory:
+   ```
+   /src/your-feature/script.js
+   /src/your-feature/style.scss
+   ```
 
-3. Enqueue your script in PHP, using the generated asset file:
+3. When you run `npm run build`, WordPress Scripts will:
+   - Compile your JavaScript file to `/build/your-feature/script.js`.
+   - Compile and minify your SCSS to `/build/your-feature/style.css`.
+   - Generate source maps.
+
+4. Enqueue your script and/or stylesheet in PHP, using the generated asset file:
 
 ```php
 /**
  * Enqueue admin scripts.
  */
 function activitypub_enqueue_admin_scripts() {
     // Load the asset file to get dependencies and version.
-    $asset_data = include ACTIVITYPUB_PLUGIN_DIR . 'build/js/your-feature.asset.php';
+    $asset_data = include ACTIVITYPUB_PLUGIN_DIR . 'build/your-feature/script.asset.php';
 
     wp_enqueue_script(
         'activitypub-your-feature',
         plugins_url(
-            'build/js/your-feature.js',
+            'build/your-feature/script.js',
             ACTIVITYPUB_PLUGIN_FILE
         ),
         $asset_data['dependencies'],
@@ -143,28 +157,15 @@ function activitypub_enqueue_admin_scripts() {
     );
 }
 add_action( 'admin_enqueue_scripts', 'activitypub_enqueue_admin_scripts' );
-```
-
-#### Adding New CSS Files
 
-1. Create your CSS source file in the `/src/css/` directory:
-   ```
-   /src/css/your-feature.css
-   ```
-
-2. When you run `npm run build`, WordPress Scripts will compile your CSS file to `/build/css/your-feature.css`.
-
-3. Enqueue your stylesheet in PHP:
-
-```php
 /**
  * Enqueue admin styles.
  */
 function activitypub_enqueue_admin_styles() {
     wp_enqueue_style(
         'activitypub-your-feature',
         plugins_url(
-            'build/css/your-feature.css',
+            'build/your-feature/style.css',
             ACTIVITYPUB_PLUGIN_FILE
         ),
         array(),