Bulk Operations

Maraikka provides powerful bulk operation capabilities that allow you to efficiently manage multiple documents, apply changes across projects, and streamline your documentation workflow.

Overview

Bulk operations help you:

• Update multiple documents simultaneously
• Apply consistent formatting across content
• Manage large documentation projects efficiently
• Perform administrative tasks at scale

Document Selection

Selecting Multiple Documents

1. Checkbox Selection: Use checkboxes in the document list
2. Shift+Click: Select a range of documents
3. Ctrl/Cmd+Click: Select individual documents
4. Filter and Select: Use filters to find specific documents

Selection Criteria

• By Status: Draft, published, or archived documents
• By Author: Documents created by specific team members
• By Date: Documents created or modified within date ranges
• By Tags: Documents with specific tags or categories

Bulk Editing Operations

Content Updates

Find and Replace

• Search for specific text across selected documents
• Replace with new content while preserving formatting
• Use regular expressions for complex patterns
• Preview changes before applying

Formatting Changes

• Apply consistent heading styles
• Update font sizes and spacing
• Standardize code block formatting
• Apply theme changes across documents

Metadata Updates

Bulk Metadata Editing

• Update titles and descriptions
• Add or remove tags
• Modify author information
• Update SEO settings

Publishing Operations

Bulk Publishing

Website Publishing

• Publish multiple documents to your website
• Update navigation and structure
• Generate new sitemaps
• Update search indexes

Export Operations

• Export multiple documents to PDF
• Generate ZIP archives of content
• Create backup copies
• Export to different formats

Administrative Tasks

User Management

Permission Updates

• Grant or revoke access to multiple documents
• Update sharing settings
• Change ownership of documents
• Manage team permissions

Organization

Document Organization

• Move documents between folders
• Apply consistent naming conventions
• Update categorization
• Archive outdated content

API for Bulk Operations

Using the Bulk API

// Example bulk operation via API
const bulkUpdate = {
  documentIds: ["doc1", "doc2", "doc3"],
  updates: {
    status: "published",
    tags: ["updated", "v2.0"],
  },
};
 
await fetch("/api/documents/bulk", {
  method: "POST",
  body: JSON.stringify(bulkUpdate),
});

Automation Scripts

Create custom scripts for regular bulk operations:

• Scheduled content updates
• Automated archiving
• Bulk import from external sources
• Regular maintenance tasks

Best Practices

Performance Considerations

• Batch Size: Limit operations to reasonable batch sizes
• Progress Monitoring: Track progress for large operations
• Error Handling: Implement proper error handling
• Backup: Always backup before bulk operations

Safety Measures

• Preview Changes: Always preview before applying
• Staging Environment: Test in staging first
• Rollback Plan: Have a rollback strategy
• Version Control: Use version control for safety

Common Use Cases

Documentation Migration

• Moving from other platforms
• Restructuring existing content
• Updating outdated information
• Standardizing formats

Content Maintenance

• Regular content reviews
• Updating product information
• Fixing broken links
• Standardizing terminology

Publishing Workflows

• Scheduled publishing
• Multi-language updates
• Version releases
• Content syndication

Troubleshooting

Common Issues

Performance Problems

• Reduce batch sizes
• Check system resources
• Optimize queries
• Use background processing

Permission Errors

• Verify user permissions
• Check document access rights
• Validate API credentials
• Review security settings

Getting Help

If you encounter issues with bulk operations:

1. Check the operation logs
2. Verify your permissions
3. Contact support with specific error messages
4. Provide details about the operation attempted

Ready to streamline your documentation workflow? Start with small batches and gradually increase complexity as you become more comfortable with bulk operations.