Solution Submission Guide
- 0 Comments
- 13,976 Views
A “solution” on opendxl.com represents a commercial or open source
product. Submitting solutions is an excellent way to showcase DXL-integrated products and projects to the OpenDXL community. The solutions are not hosted on this site, but instead reside on the vendor’s site for commercial projects. For open source projects the solutions are typically hosted in a source code repository (For example, GitHub).
Solutions are categorized for easy searching. Additionally, during submission, “tags” and rich text descriptions can be provided to describe the capabilities of the solution. A solution can be updated by the submitter at any time, and as new versions of a solution are released, a “version” can be added to that solution that includes version-specific details (a version-specific URL, release notes, etc.).
Solution Submission Requirements
Only registered users can submit solutions to the community. If you are not a registered user, you can sign up here.
Solutions are moderated and must meet the criteria below to be approved.
- Documentation suitable to install and use the solution
- An introductory description of the Solution in the beginning of the documentation
- Clearly defined installation requirements and dependencies
- Examples of functionality, and necessary steps to customize features (such as message payloads)
- Correct grammar and spelling
- When possible, the solution should include the ability to automatically resolve required dependencies. For example, Python-based solutions should include an automated method for installing the Python dependencies (via setup.py, requirements.txt, etc.).
- Icons submitted with solutions should be 144x144 in size
- Any text or image(s) in the icon should be clear and legible (no obvious scaling)
- Solutions should be submitted based on an official released or tagged version. For example, an open-source project on GitHub should utilize a GitHub Project Release
Please refer to existing solutions on the OpenDXL GitHub as examples for meeting all of the above criteria:
Submitting a Solution
Once a solution meets the solution submission requirements, submitting the solution to the OpenDXL community is straight-forward.
First, go to the Solutions page and select "Add Solution".
Then fill in the Solution Submission form fields listed below.
Solution Submission Form Fields
See the "Solution Information Display" section below for a sample of a submitted solution and how the information entered will appear to users browsing the site.
Solution Information Display
After submission, the Solution is displayed as shown below.
After a Solution is submitted and approved, a Forum thread is automatically created for discussions in the Solution Releases section. This facilitates discussions regarding the posted solution.
Adding New Versions
After a Solution has been added, it can be updated later to announce additional versions. To be able to add a new version to an existing solution, the user must be signed in as the Solution submitter or an “additional author” as assigned by that submitter.
Open your Solution’s details page and choose the “Add Version” button at the bottom of the screen.
- Specify the URL for the version being submitted.
- Specify the version in the Version column.
- Provide the description of the version in the Description column.
Solution submissions are moderated to ensure quality. Solution submissions are not visible to all users until they have been approved by the opendxl.com moderation team. This is indicated by the “eye with a slash” symbol (indicating the solution is not visible) either replacing or overlaying the submitted Solution’s icon:
Once a solution has been submitted and approved, it is made public for the OpenDXL community.