> ## Documentation Index
> Fetch the complete documentation index at: https://dos.dzaleka.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Support

> Find help, report issues, and connect with the Dzaleka Online Services community

## Welcome to Support

Need help with Dzaleka Online Services? Whether you're experiencing technical issues, have questions about contributing, or need assistance using the platform, we're here to help!

<Note>
  We're committed to providing timely and helpful support to everyone in our community.
</Note>

## Quick Links

<CardGroup cols={2}>
  <Card title="GitHub Issues" icon="github" href="https://github.com/Dzaleka-Connect/dos/issues">
    Report bugs or request features
  </Card>

  <Card title="Email Support" icon="envelope" href="mailto:dzalekaconnect@gmail.com">
    Contact us directly
  </Card>

  <Card title="Documentation" icon="book" href="/introduction">
    Browse our guides and docs
  </Card>

  <Card title="Contributing Guide" icon="code" href="/community/contributing">
    Learn how to contribute
  </Card>
</CardGroup>

## Getting Help

### Before You Ask

Before reaching out for support, please:

<Steps>
  <Step title="Search Documentation">
    Check our [documentation](/introduction) for answers to common questions.
  </Step>

  <Step title="Check Existing Issues">
    Search [GitHub Issues](https://github.com/Dzaleka-Connect/dos/issues) to see if your question has been answered.
  </Step>

  <Step title="Review FAQs">
    Look through the Frequently Asked Questions below.
  </Step>
</Steps>

### How to Get Help

Choose the best method for your needs:

<Tabs>
  <Tab title="Technical Issues">
    **For bugs, errors, or technical problems:**

    <Steps>
      <Step title="Gather Information">
        Before reporting, collect:

        * What you were trying to do
        * What you expected to happen
        * What actually happened
        * Browser and version
        * Screenshots or error messages
        * Steps to reproduce the issue
      </Step>

      <Step title="Create GitHub Issue">
        1. Go to [GitHub Issues](https://github.com/Dzaleka-Connect/dos/issues)
        2. Click "New Issue"
        3. Choose "Bug Report" template
        4. Fill in all required information
        5. Add relevant labels
        6. Submit the issue
      </Step>

      <Step title="Wait for Response">
        Our team will review and respond within 2-3 business days
      </Step>
    </Steps>

    <Warning>
      Always check if your issue has already been reported before creating a new one.
    </Warning>
  </Tab>

  <Tab title="Feature Requests">
    **Have an idea to improve the platform?**

    <Steps>
      <Step title="Describe Your Idea">
        Think about:

        * What problem does it solve?
        * Who would benefit?
        * How should it work?
        * Any examples from other platforms?
      </Step>

      <Step title="Submit Request">
        1. Go to [GitHub Issues](https://github.com/Dzaleka-Connect/dos/issues)
        2. Click "New Issue"
        3. Choose "Feature Request" template
        4. Describe your idea clearly
        5. Add mockups or examples if possible
        6. Submit the request
      </Step>

      <Step title="Community Discussion">
        The community will discuss and vote on feature requests
      </Step>
    </Steps>

    <Info>
      Feature requests are reviewed regularly by our team and prioritized based on community needs.
    </Info>
  </Tab>

  <Tab title="Content Questions">
    **Questions about services, events, or content?**

    For questions about:

    * Listing your service or organization
    * Updating existing information
    * Reporting incorrect content
    * Content guidelines

    **Email us at:** [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)

    Include:

    * Your name and organization (if applicable)
    * What information you need to add/update
    * Contact details for verification

    <Tip>
      Response time for content inquiries: 3-5 business days
    </Tip>
  </Tab>

  <Tab title="General Questions">
    **Other questions or feedback?**

    **Email:** [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)

    We're happy to help with:

    * General platform questions
    * Partnership inquiries
    * Community collaboration
    * Media requests
    * Accessibility concerns
    * Privacy questions

    <Check>We typically respond within 2-3 business days</Check>
  </Tab>
</Tabs>

## Reporting Issues

### Bug Reports

When reporting a bug, provide:

<Accordion title="Essential Information">
  **Environment:**

  * Operating System (Windows, macOS, Linux)
  * Browser and version
  * Device type (desktop, mobile, tablet)

  **Issue Details:**

  * Clear description of the problem
  * Steps to reproduce
  * Expected behavior
  * Actual behavior
  * Screenshots or screen recordings
  * Error messages (full text)
  * Console errors (press F12 in browser)

  **Additional Context:**

  * When did it start happening?
  * Does it happen consistently?
  * Have you tried any workarounds?
</Accordion>

### Good Bug Report Example

```markdown theme={null}
**Bug:** Search not returning results for services

**Environment:**
- OS: Windows 11
- Browser: Chrome 120
- Device: Desktop

**Steps to Reproduce:**
1. Go to Services page
2. Enter "education" in search box
3. Press Enter
4. No results appear

**Expected:** List of education services
**Actual:** Empty results, no error message

**Screenshots:** [attached]
**Console Errors:** TypeError: Cannot read property 'filter' of undefined

**Additional Info:** 
- Started happening today
- Happens with all search terms
- Works in Firefox
```

<Tip>
  The more detailed your bug report, the faster we can fix the issue!
</Tip>

## Contact Information

### Primary Contacts

<CardGroup cols={1}>
  <Card title="Email" icon="envelope">
    **[dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)**

    For all inquiries, support requests, and general questions

    Response time: 2-3 business days
  </Card>

  <Card title="GitHub" icon="github">
    **[github.com/Dzaleka-Connect/dos](https://github.com/Dzaleka-Connect/dos)**

    For technical issues, feature requests, and code contributions

    Response time: 2-3 business days
  </Card>

  <Card title="Physical Location" icon="location-dot">
    **Dzaleka Refugee Camp**

    Dowa District, Malawi
  </Card>
</CardGroup>

### Social Media

Connect with us on social media:

* **Facebook:** [@dzalekaonline](https://facebook.com/dzalekaonline)
* **Twitter:** [@dzalekaconnect](https://twitter.com/dzalekaconnect)
* **Instagram:** [@dzalekaonline](https://instagram.com/dzalekaonline)

<Note>
  For urgent issues, email is the fastest way to reach us. Social media messages may take longer to receive a response.
</Note>

## Community Resources

### Documentation

Explore our comprehensive documentation:

<CardGroup cols={2}>
  <Card title="Getting Started" icon="rocket" href="/introduction">
    New to the platform? Start here
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Technical API documentation
  </Card>

  <Card title="Guides" icon="book-open" href="/guides">
    Step-by-step tutorials
  </Card>

  <Card title="Best Practices" icon="lightbulb" href="/guides/best-practices">
    Learn optimal approaches
  </Card>
</CardGroup>

### GitHub Resources

* **[Issues](https://github.com/Dzaleka-Connect/dos/issues)** - Report bugs and request features
* **[Discussions](https://github.com/Dzaleka-Connect/dos/discussions)** - Community conversations
* **[Pull Requests](https://github.com/Dzaleka-Connect/dos/pulls)** - Code contributions
* **[Wiki](https://github.com/Dzaleka-Connect/dos/wiki)** - Additional documentation

### Contributing

Want to help improve the platform?

<Steps>
  <Step title="Read Contributing Guide">
    Start with our [Contributing Guide](/community/contributing)
  </Step>

  <Step title="Find an Issue">
    Look for issues labeled `good first issue` or `help wanted`
  </Step>

  <Step title="Join the Community">
    Participate in discussions and code reviews
  </Step>
</Steps>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="How do I add my organization to the platform?">
    To list your organization:

    1. Email us at [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com) with:
       * Organization name and description
       * Services provided
       * Contact information
       * Logo/images (if available)

    2. We'll review your submission within 5 business days

    3. Once approved, your listing will appear on the Services page

    Alternatively, you can submit a pull request on GitHub if you're comfortable with technical contributions.
  </Accordion>

  <Accordion title="How can I update information about my service?">
    To update existing information:

    * **Email:** Send updates to [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)
    * **GitHub:** Submit a pull request with changes
    * **Direct:** Contact us via the website contact form

    Include proof of authorization to make changes on behalf of the organization.
  </Accordion>

  <Accordion title="I found incorrect information. How do I report it?">
    Report incorrect information by:

    1. Creating a GitHub issue with the "Content Error" label
    2. Emailing [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com) with details
    3. Using the contact form on the website

    Please include:

    * Link to the page with incorrect information
    * What's incorrect
    * What the correct information should be
    * Source for the correct information (if applicable)
  </Accordion>

  <Accordion title="How do I contribute code to the project?">
    To contribute code:

    1. Read the [Contributing Guide](/community/contributing)
    2. Fork the repository on GitHub
    3. Create a branch for your changes
    4. Make your changes and test thoroughly
    5. Submit a pull request
    6. Respond to code review feedback

    See our [Development Setup](/community/contributing#development-setup) for detailed instructions.
  </Accordion>

  <Accordion title="Is the platform available in multiple languages?">
    Currently, the platform is primarily in English. We're working on multi-language support.

    If you'd like to help translate the platform, please email [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com).
  </Accordion>

  <Accordion title="How can I sponsor or support the project?">
    We welcome partnerships and support! Contact us at [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com) to discuss:

    * Financial sponsorship
    * Technical resources
    * Community partnerships
    * Volunteer opportunities
  </Accordion>

  <Accordion title="The website is slow or not loading. What should I do?">
    If you experience performance issues:

    1. **Check your internet connection**
    2. **Clear browser cache and cookies**
    3. **Try a different browser**
    4. **Check [GitHub Issues](https://github.com/Dzaleka-Connect/dos/issues) for known outages**

    If problems persist, report them via GitHub or email with details about your browser, device, and what you were trying to do.
  </Accordion>

  <Accordion title="How is my data protected on the platform?">
    We take privacy seriously:

    * We collect minimal personal information
    * Data is not shared with third parties without consent
    * We use secure connections (HTTPS)
    * Contact forms are processed securely via Formspree

    For detailed privacy information, see our Privacy Policy.
  </Accordion>
</AccordionGroup>

## Response Times

<Info>
  We strive to respond to all inquiries promptly, but response times may vary based on volume and complexity.
</Info>

| Channel          | Typical Response Time |
| ---------------- | --------------------- |
| Email            | 2-3 business days     |
| GitHub Issues    | 2-3 business days     |
| Social Media     | 3-5 business days     |
| Content Requests | 3-5 business days     |
| Feature Requests | Reviewed monthly      |

<Warning>
  For urgent security issues, please email us immediately at [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com) with "SECURITY" in the subject line.
</Warning>

## Accessibility Support

We're committed to making Dzaleka Online Services accessible to everyone.

If you encounter accessibility barriers:

* **Email:** [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)
* **Subject:** Accessibility Issue
* **Include:** Description of the barrier and how it affects you

We'll work to address accessibility issues as a priority.

## Emergency Contact

For critical issues affecting the platform or community safety:

**Email:** [dzalekaconnect@gmail.com](mailto:dzalekaconnect@gmail.com)
**Subject:** URGENT - \[Brief Description]

<Warning>
  Only use this for genuine emergencies, such as security vulnerabilities or content that violates our Code of Conduct.
</Warning>

***

<CardGroup cols={2}>
  <Card title="Code of Conduct" icon="shield" href="/community/code-of-conduct">
    Read our community guidelines
  </Card>

  <Card title="Contributing" icon="code-branch" href="/community/contributing">
    Learn how to contribute
  </Card>
</CardGroup>

**We're here to help! Don't hesitate to reach out with questions or concerns.**