You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Xinwei Xiong
cd7f35452e
|
9 months ago | |
---|---|---|
.. | ||
contrib | 9 months ago | |
contributing | 10 months ago | |
images | 10 months ago | |
readme | 9 months ago | |
.generated_docs | 10 months ago | |
CODEOWNERS | 12 months ago | |
README.md | 10 months ago |
README.md
OpenIM Server Docs
Welcome to the OpenIM Documentation hub! This center provides a comprehensive range of guides and manuals designed to help you get the most out of your OpenIM experience.
Table of Contents
- Contrib - Guidance on contributing and configurations for developers
- Conversions - Coding conventions, logging policies, and other transformation tools
Contrib
This section offers developers a detailed guide on how to contribute code, set up their environment, and follow the associated processes.
- Code Conventions - Rules and conventions for writing code in OpenIM.
- Development Guide - A guide on how to carry out development within OpenIM.
- Git Cherry Pick - Guidelines on cherry-picking operations.
- Git Workflow - The git workflow in OpenIM.
- Initialization Configurations - Guidance on setting up and initializing OpenIM.
- Docker Installation - How to install Docker on your machine.
- Linux Development Environment - Guide to set up the development environment on Linux.
- Local Actions - Guidelines on how to carry out certain common actions locally.
- Offline Deployment - Methods of deploying OpenIM offline.
- Protoc Tools - Guide on using protoc tools.
- Go Tools - Tools and libraries in OpenIM for Go.
- Makefile Tools - Best practices and tools for Makefile.
- Script Tools - Best practices and tools for scripts.
Conversions
This section introduces various conventions and policies within OpenIM, encompassing code, logs, versions, and more.
- API Conversions - Guidelines and methods for API conversions.
- Logging Policy - Logging policies and conventions in OpenIM.
- CI/CD Actions - Procedures and conventions for CI/CD.
- Commit Conventions - Conventions for code commits in OpenIM.
- Directory Conventions - Directory structure and conventions within OpenIM.
- Error Codes - List and descriptions of error codes.
- Go Code Conversions - Conventions and conversions for Go code.
- Docker Image Strategy - Management strategies for OpenIM Docker images, spanning multiple architectures and image repositories.
- Logging Conventions - Further detailed conventions on logging.
- Version Conventions - Naming and management strategies for OpenIM versions.
For Developers, Contributors, and Community Maintainers
Developers & Contributors
If you're a developer or someone keen on contributing:
- Familiarize yourself with our Code Conventions and Git Workflow to ensure smooth contributions.
- Dive into the Development Guide to get a hang of the development practices in OpenIM.
Community Maintainers
As a community maintainer:
- Ensure that contributions align with the standards outlined in our documentation.
- Regularly review the Logging Policy and Error Codes to stay updated.
For Users
Users should pay particular attention to:
- Docker Installation - Necessary if you're planning to use Docker images of OpenIM.
- Docker Image Strategy - To understand the different images available and how to choose the right one for your architecture.