SmartContent & Canvas Troubleshooting

This guide provides system requirements, limitations, and troubleshooting guidance for using SmartContent and the Canvas editor. If you encounter issues while collaborating, editing, or managing your documents, use the solutions below to resolve them.

System Requirements and Limitations

Browser Compatibility

SmartContent & Canvas work best with modern browsers:

• Chrome: Version 90 or later
• Firefox: Version 88 or later
• Safari: Version 14 or later
• Edge: Version 90 or later

Older browsers may experience limited functionality or performance issues.

Performance Considerations

The following factors can affect performance:

• Document Size: Very large documents (>100,000 characters) may experience slower performance
• Concurrent Users: Multiple users editing simultaneously may impact responsiveness
• Complex Formatting: Documents with extensive formatting or embedded content may load more slowly
• Browser Resources: Limited system memory or CPU can affect performance

Content Limitations

Be aware of these content limitations:

• Maximum Document Size: 10MB for most document types
• Image Handling: Images must be under 5MB each
• Supported Formats:
  • Text: Plain text, Markdown, HTML
  • Images: PNG, JPEG, GIF, SVG
  • Code: Most major programming languages
• Export Limitations: Some formatting may not translate perfectly when exporting to certain formats

---

Common Issues and Solutions

Canvas Not Appearing

Symptoms: Canvas doesn't appear when requested, or the Peer doesn't recognize Canvas commands.

Possible Causes and Solutions:

1. Canvas Tool Not Added:

   • Verify the Peer has the Canvas tool added
   • Check tool configuration in the Peer settings

2. Command Not Recognized:

   • Try different phrasing: "Open canvas" or "Let's create a document"
   • Be more explicit about wanting to use Canvas

3. Browser Issues:

   • Clear browser cache and reload
   • Try a different supported browser

Editor Loading Problems

Symptoms: Canvas appears but the editor doesn't load properly or shows errors.

Possible Causes and Solutions:

1. Browser Compatibility:

   • Update to the latest browser version
   • Disable browser extensions that might interfere

2. Resource Limitations:

   • Close other resource-intensive tabs or applications
   • Reload the page to free up resources

3. Network Issues:

   • Check your internet connection
   • Try again when connection is stable

Content Saving Issues

Symptoms: Unable to save documents or content disappears after saving.

Possible Causes and Solutions:

1. Network Interruption:

   • Ensure stable internet connection
   • Copy content to clipboard as backup before saving

2. Permission Issues:

   • Verify you have appropriate permissions
   • Check with your administrator if permissions seem incorrect

3. Storage Limitations:

   • Check if you've reached storage limits
   • Remove unnecessary documents to free up space

Formatting Problems

Symptoms: Document formatting appears incorrect or inconsistent.

Possible Causes and Solutions:

1. Editor Switching:

   • Avoid switching between Markdown and Code editors for the same document
   • Export and re-import if formatting is corrupted

2. Complex Formatting:

   • Simplify complex formatting structures
   • Break large tables or nested elements into smaller components

3. Export Format Compatibility:

   • Some formatting may not translate to all export formats
   • Try different export formats to find the best compatibility

Collaboration Issues

Symptoms: Multiple users experience conflicts or lost changes.

Possible Causes and Solutions:

1. Concurrent Editing Conflicts:

   • Coordinate editing different sections of the document
   • Communicate with other users about which sections you're working on
   • Wait for others to complete their edits before editing the same section

2. Synchronization Delays:

   • Allow time for changes to synchronize across users
   • Refresh the document if changes aren't appearing
   • Save frequently to ensure changes are preserved

3. User Permission Conflicts:

   • Ensure all users have appropriate edit permissions
   • Consider using a document owner to manage final changes
   • Establish clear roles for who can edit which sections

---

Advanced Troubleshooting

Diagnostic Tools

Cognipeer provides several diagnostic tools for SmartContent & Canvas issues:

1. Canvas Status Check:

   • In a conversation, type "/canvas status" to check the tool's status
   • The Peer will report on Canvas availability and configuration

2. Document Repair:

   • For corrupted documents, use "/repair [document name]" in a conversation
   • The system will attempt to recover the document structure

3. Support Details:

   • Note what you were doing when the issue happened
   • Capture the document name and approximate time
   • Share any visible error message with support

Recovering Lost Content

If you experience content loss:

1. Version History:

   • Check the document's version history for recoverable versions
   • Restore a previous version if available

2. Autosave Recovery:

   • Look for autosaved versions in the SmartContent library
   • Documents with "(Autosave)" in the title may contain recent changes

3. Browser Recovery:

   • Some browsers cache form content
   • Try using browser back/forward navigation to recover unsaved content

Contacting Support

If you cannot resolve an issue:

1. Gather Information:

   • Document name and ID
   • Steps to reproduce the issue
   • Error messages (if any)
   • Browser and version
   • Screenshots of the problem

2. Internal Support:

   • Contact your organization's Cognipeer administrator
   • Provide the gathered information

3. Cognipeer Support:

   • If internal support cannot resolve the issue, contact Cognipeer support
   • Include all relevant information and any troubleshooting steps already attempted

---

Future Enhancements

As SmartContent & Canvas are relatively new features, several enhancements are planned:

Upcoming Improvements

1. Performance Optimization:

   • Faster loading for large documents
   • Improved real-time collaboration

2. Enhanced Editing Tools:

   • Additional editor types for specialized content
   • More formatting options and templates

3. Integration Enhancements:

   • Deeper integration with external document systems
   • Improved workflow automation capabilities

4. User Experience Refinements:

   • Streamlined interface for common tasks
   • More intuitive collaboration features

Feature Requests

If you have suggestions for improving SmartContent & Canvas:

1. Submit feature requests through your organization's Cognipeer administrator
2. Provide detailed use cases and benefits for your suggestions
3. Participate in user feedback sessions when available

---

Best Practices for Optimal Performance

Document Management

• Size Management: Break very large documents into smaller, linked documents
• Regular Cleanup: Archive or delete unused documents to maintain library performance
• Structured Organization: Use consistent naming and tagging for easier management

Editing Efficiency

• Section Focus: Work on one section at a time, especially in collaborative sessions
• Progressive Saving: Save incrementally as you work, rather than only at completion
• Format Simplicity: Use simpler formatting when possible for better performance

Collaboration Optimization

• Clear Communication: Establish clear roles and sections for each collaborator
• Scheduled Collaboration: For complex documents, schedule dedicated collaboration sessions
• Feedback Loops: Implement regular review cycles for collaborative documents

By understanding the technical aspects of SmartContent & Canvas and following these best practices, you can optimize your experience with these features and minimize potential issues.