e7cf4f1e09
- Fix update_post() wrapper documentation (post_id -> post_text/post_path/post_key) - Fix create_comment() wrapper documentation (added post_slug, post_key parameters) - Add missing wrapper docs for follow(), trust(), votecast(), react() - Fix reaction job parameters (parent_id -> parent_sk, corrected payload structure) - Fix trust job parameters (updated to match actual payload structure) - Fix vote job parameters (voteType -> vote, added parent structure) - Clearly mark Block and Mute jobs as NOT IMPLEMENTED - Fix GitLab URLs to Forgejo (git.jezzahehn.com) - Remove LLM-style language (comprehensive -> full/thorough) - Fix trust listbyusersinit parameter (username -> user_id)
4.4 KiB
4.4 KiB
TrustCafé API Wrapper - Documentation Index
Complete documentation for the TrustCafé API wrapper.
Getting Started
New to the wrapper? Start here.
- Getting Started Guide - Complete setup and configuration guide
- README.md - Overview package information and installation
Core Usage
Learn how to use the API wrapper effectively.
- Wrappers Guide - High-level wrappers for common operations
- API Reference - Complete API job reference
- Custom Requests Guide - Making advanced API calls manually
Development
Contributing or extending the wrapper.
- Development Guide - Development notes, design decisions, and known limitations
- Examples - Real-world usage examples
Support and Troubleshooting
Having issues? Find solutions here.
- Troubleshooting Guide - Common issues and solutions
Quick Links
For New Users
For In-Depth Learning
- Wrappers - Start here for easiest usage
- API Reference - Deep dive into all jobs
- Creating Custom Wrappers
For Developers
Documentation Contents
Getting Started (GETTING_STARTED.md)
- Installation steps
- API credentials setup
- Environment configuration
- First API call example
- Token management best practices
- Setup patterns for different environments
Wrappers Guide (WRAPPERS.md)
- Overview of wrapper system
- Post wrapper documentation (create_post, update_post)
- Comment wrapper documentation (create_comment)
- Wrapper best practices
- Wrapper vs Job comparison
- Creating custom wrappers
API Reference (API_REFERENCE.md)
- All available Jobs
- Complete job parameters and return values
- Authentication job documentation
- Post, Comment, UserProfile, Follow, Vote jobs
- Reaction, Notification, Trust, Branch jobs
- Feed operations
- Error handling patterns
- Pagination guide
Custom Requests Guide (CUSTOM_REQUESTS.md)
- Using the
make_requestmethod - Advanced usage patterns
- Pagination strategies
- Batch operations
- Error handling for custom calls
- Complex query examples
Troubleshooting Guide (TROUBLESHOOTING.md)
- Authentication issues
- Connection problems
- Token management errors
- API call issues
- Environment issues
- Data handling problems
- Performance issues
- Debugging strategies
Development Guide (development.md)
- Project structure
- Design decisions and debates
- Known limitations
- Missing features
- Future enhancements
- Contributing guidelines
- Testing guide
- Extension instructions
Support
If you can't find the answer you're looking for:
- Check the FAQs section - Common questions and answers
- Review the Troubleshooting guide - For specific error handling
- Contact WikiTribune team - Via company channels
- File an issue on Forgejo - Repository Issues
Changelog
Document version updates should be listed here.
v0.2.0 (Current)
- Complete rewrite and enhancement of all documentation
- Added full API reference
- Added wrappers guide
- Added custom requests guide
- Added detailed troubleshooting section
- Enhanced development documentation
- Improved README.md structure and examples
v0.1.0.13
- Initial release with basic documentation
- Minimum set of jobs and wrappers
Contributing to Documentation
If you find any documentation issues:
- Typos or errors - Correct in the markdown file
- Outdated examples - Update with correct code
- Missing information - Add to the appropriate section
- Unclear explanations - Improve wording for clarity
When contributing documentation remember:
- Keep examples working
- Maintain consistent formatting
- Use proper markdown syntax
- Link to related documentation
- Update this INDEX.md if structure changes
Last Updated: April 18, 2026