Archway Discussions - Contributing

[zanicar]

Archway Discussions - Contributing

Photo by Stefano Zocca on Unsplash

Archway Discussions welcomes all contributors.

This document serves as a guide for contributing to Archway Discussions. It provides an overview of the processes and policies established for quality collaboration and coordination. Please familiarize yourself with these guidelines and feel free to propose changes to this document for improvement.

License

Important: All 3rd party contributions to this repository and to Archway Discussions are made under the Apache License 2.0, unless otherwise agreed to in writing.

General Guidelines

Please follow these guidelines when creating a new topic or discussion.

For technical contributions to any particular repository, please refer to the contribution guidelines published in the repository. For example, see the following contribution guidelines for the Archway Protocol.

Structure

A good discussion should contain the following elements:

Background

Provide a brief overview of the subject to set the stage or to provide the necessary context.

Include the rationale, a statement or paragraph that highlights the value that can be added, the utility that may be gained, or the problem that could be addressed.

Provide some relevant examples, as these serve to communicate clear use cases or instances of potential issues or value addition.

Question

Pose a question to solicit a discussion on the desired topic.

For example:

• "Will feature X be useful for other developers?"
• "Will feature X significantly affect performance / security?"
• "Does having X solve Y?"
• "Is it technically feasible to attempt X?"

This is also a great opportunity to reference current and ongoing research relevant to the question at hand, or to highlight past, present or upcoming potential solutions.

Refrain from attempting to answer the question at this point. Doing so runs the risk of "Begging the Question", leading the discussion and potentially alienating other community members from engaging as the perception may be that the outcome is already assumed...

Examples

The following discussion and issue exemplify solicitation of open discussion respectively:

• Discussion: Data Privacy in CosmWasm Smart Contracts
• Issue: Enhancing Querying and Withdrawals of Rewards