The Marrow Mongo Document Mapper
  • Introduction
  • Installation
  • Contributing
  • Guide
    • Introduction
    • Modelling
    • Management
    • Interaction
    • Fields
    • Indexes
    • Trait Mix-Ins
    • Plugin Namespaces
  • Reference
    • Decimal
    • Field
    • Index
    • Fields
      • Alias
      • Array
      • Binary
      • Boolean
      • Date
      • Double
      • Embed
      • Integer
      • Link
      • Long
      • Mapping
      • Markdown
      • Number
      • ObjectId
      • Path
      • Period
      • Plugin
      • Reference
      • Regex
      • Set
      • String
      • TTL
      • Timestamp
    • Parametric
      • F (Filter)
      • P (Project)
      • S (Sort)
      • U (Update)
    • Query
      • Ops
      • Q
    • Traits
      • Collection
      • Derived
      • Expires
      • Heirarchical
      • Identified
      • Localized
      • Lockable
      • Published
      • Stateful
      • Queryable
    • Utilities
      • Capped Collections
      • Geospatial
      • Logging
  • End Matter
    • Colophon
    • License
    • History
Powered by GitBook
On this page
  • Table of Contents
  • Asking Questions
  • First Steps
  • Guidelines
  • Donations and Patreon Support

Was this helpful?

Edit on Git

Contributing

PreviousInstallationNextIntroduction

Last updated 6 years ago

Was this helpful?

Thank you for considering contributing to this project! We welcome contributions large and small, from documentation to code. Following these guidelines helps communicate that you respect the time of the developers managing and developing this open source project. In return, we will recriprocate that respect in addressing your issue, assessing changes, and helping you finalize your pull requests.

There are many ways to contribute, from advocacy through writing tutorials or blog posts, improving or translating the documentation, submitting bug reports and feature requests, or writing code which can be incorporated into future Marrow Mongo releases.

Table of Contents

Asking Questions

The first step in determining how best to tackle a concern is to ask about it. There are a number of avenues available for discussion and support.

  • Freenode IRC

    Likely the best way to get fast turnaround on inquiries is through the Marrow Open Source Collective community on Freenode IRC. Point your IRC client at the #webcore channel on chat.freenode.net:6667 (SSL; non-SSL port 6667) or, if you are viewing this on a medium which supports it and have an IRC client installed which recognizes irc:// URLs, just .

    If you have general Python questions, or general MongoDB questions, , , or , as appropraite, may be more active. Stack Overflow is also worth considering.

  • Stack Overflow

    To help develop a comprehensive knowledgebase of problems and solutions, with good metadata, user incentives, and fancy native apps, you can utilize Stack Overflow to ask your questions. Just remember to tag your question so that it can be found.

  • GitHub Issues

    For problems relating to bugs or enhancements witin Marrow Mongo itself, please utilize the provided by GitHub. If you have identified an issue and have already begun work on a feature branch, just issue a pull request instead of creating a ticket, then creating a pull request.

    Please do not use the issue tracker for general support questions. IRC or Stack Overflow are better resources for quick questions or longer questions, respectively.

First Steps

  • Triage

  • Help Wanted

  • Write Some Documentation

Guidelines

  • Start small.

    It'll be less overwhelming to tackle a small, focused problem, and easier to get feedback.

  • Leave feedback.

    See an idea being discussed, or a work-in-progress you feel could use your input? Do not hesitate to comment anywhere at any time.

  • Large (especially breaking) changes should be discussed.

  • Be excellent to each-other.

  • Code quality is a key priority.

    We love code. To ensure our code is understandable and maintainable long into the future it is important that changes:

    1. Ensure cross-runtime (CPython, Pypy) and cross-version (2.7, 3.x) compatibility.

    2. Ensure code coverage and code health do not decrease.

    3. Ensure changes are up to date with their parent branch and that they do not conflict.

Donations and Patreon Support

If at any point you wish or need to cease recurring donations, do not feel bad. Don't put yourself out on our account, and thank you!

If you find an reporting a bug, try to reproduce it. If the problem appears valid make a note that you confirmed the bug.

Look through the issues on GitHub. Look for tickets with greater numbers of reactions and comments to help gauge impact. If you feel it's a problem you can help solve, ask to be assigned.

We like to think that Marrow Mongo's documentation is excellent, but there's always room for improvement. Did you find a typo? Do you feel a certain section is unclear? Let us know by leaving a comment on the web version of this document—hover over a paragraph, use the speech bubble on the right—or feel free to contrbute to the .

for any major changes and enhancements that you wish to make. Discuss things transparently and get community feedback.

Be welcoming to newcomers and encourage diverse new contributors from all backgrounds. See the .

Financial contributions are welcome. To arrange a one-time donation, please contact GothAlice on IRC (see details above) and for more ongoing support we have prepared for you. We have rewards (such as inclusion in the and our eternal gratitude) and goals, so please give it a look; every cent helps pay for infrastructure costs and caffeine. So much caffine.

unreviewed ticket
Help Wanted
book
Create issues
Python Community Code of Conduct
Patreon
Patrons team on GitHub
use this link
##python-friendly
#python
#mongodb
marrow.mongo
Marrow Mongo Issue Tracker
Asking Questions
First Steps
Guidelines
Donations and Patreon Support