Merge pull request #19 from SomeRandomiOSDev/Updates

Bulk updates

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,120 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+somerandomiosdev@gmail.com. All complaints will be reviewed and investigated 
+promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, available at https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

.github/CONTRIBUTING.md

@@ -0,0 +1,46 @@
+## Before getting started
+
+I just want to say a special thanks for looking to improve this project. I truly love the open source community and it wouldn't be what it is today without people like you.
+
+# How to contribute
+
+There are three main ways in which you contribute:
+
+1. Open a [Bug Report](https://github.com/SomeRandomiOSDev/CBORCoding/issues/new?assignees=SomeRandomiOSDev&labels=bug&template=BUG_REPORT.yml&title=%5BBUG%5D%3A+).
+2. Open a [Feature Request](https://github.com/SomeRandomiOSDev/CBORCoding/issues/new?assignees=SomeRandomiOSDev&labels=enhancement&template=FEATURE_REQUEST.yml&title=%5BFEATURE%5D%3A+).
+3. Create a [Pull Request](https://github.com/SomeRandomiOSDev/CBORCoding/compare).
+
+> If none of these really suit your needs, you could also open a [blank issue](https://github.com/SomeRandomiOSDev/CBORCoding/issues/new).
+
+If you need further guidance or have additional questions, you can always reach out at
+
+* somerandomiosdev@gmail.com
+
+Please also note we have a [code of conduct](#code-of-conduct), please follow it in all your interactions with the project.
+
+## Getting started
+
+For contributing via *Bug Reports* or *Feature Requests* contribuing is as simple as opening that specific issue. 
+
+> We use GitHub issue forms for submitting these types of issues. For reference, those form templates can be found [here](ISSUE_TEMPLATE/BUG_REPORT.yml) for Bug Reports and [here](ISSUE_TEMPLATE/FEATURE_REQUEST.yml) for Feature Requests.
+
+For contributing via *Pull Requests*, we ask the following of you prior to opening a `pull request` to help maintain code standards and quality (many of these are enforced with workflows, but who wants to push subsequent commits for a single PR?):
+
+* Please try and follow the implicit code conventions and naming schemes present within the project.
+* All Swift files for this project lint successfully. The latest version of SwiftLint should be used for linting.
+* The builds for all platforms should succeed, along with all of the unit tests for each platform.
+* Any new code added should be accompanied by appropriate unit test code to cover (virtually) all cases and paths through that code. The code coverage for this project shouldn't decrease by a significant amount, but increases in code coverage are always welcome and appreciated.
+* Any new public APIs added should be accompanied by documentation in code, and as appropriate, in the [README](../README.md) file and in the Documentation Catalog.
+* Since this project is available via [CocoaPods](https://cocoapods.org), it should lint successfully for both `pod lib lint` and `pod lib lint --use-libraries` using the latest version of the `pod` utility.
+
+> Tip: It's strongly recommended to use the [workflowtests.sh](../scripts/workflowtests.sh) script for testing all of the various builds & linting as this script is a mirror of the workflows that are ran for `pull requests`.
+
+For further guidance about requirements for `pull requests`, please see the [Pull Request Guidelines](PULL_REQUEST_TEMPLATE.md) document.
+
+## Code of Conduct
+
+As far as it pertains to contributions to this project, we do not and will not discriminate against people on any grouds aside from those contributions. Furthermore, discrimination from other persons will not be tolerated in any capacity. 
+
+We may, at our own discretion, remove, block from commenting/contributing, or otherwise persons who violate these guideline or those laid out below in order to maintain and inclusive productive community.
+
+For the full text of these guidelines, please read the [CODE_OF_CONDUCT](CODE_OF_CONDUCT.md) document.

.github/CONTRIBUTORS.md

@@ -0,0 +1,13 @@
+# Contributors
+
+## Special thanks for all the people who have contributed this project so far
+
+I would like to give a special thanks to all of the people below who have contributed to this project and to all of those who will contribute to it moving forward.
+
+- [Jos Kuijpers](https://github.com/joskuijpers)
+
+## I would like to join this list! How can I help the project?
+
+We appreciate your enthusiam and would love to have your contribution! We are constantly looking for ways to improve this project and often suffer from (code) writers block, sometimes stagnating progress. That's where you come in! Whether you're reporting bugs, suggesting features, or writing code yourself, we want it!
+
+For more information on how to contribute (and have your name show up here), please refer to our [CONTRIBUTING](CONTRIBUTING.md) guide.

.github/ISSUE_TEMPLATE/BUG_REPORT.yml

@@ -0,0 +1,97 @@
+name: Bug Report
+description: Create a report to help us improve this project!
+title: "[BUG]: "
+labels: ["bug"]
+assignees:
+  - SomeRandomiOSDev
+
+body:
+  - type: markdown
+    attributes:
+      value: "Thanks for taking the time to fill out this bug report!"
+
+  - type: textarea
+    id: expected-behavior
+    attributes:
+      label: "Expected Behavior"
+      description: "A clear and concise description of what you expected to happen."
+      placeholder: "What was supposed to happen?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual-behavior
+    attributes:
+      label: "Actual Behavior"
+      description: "A clear and concise description of what actually happened."
+      placeholder: "What actually happened?"
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: "Steps To Reproduce"
+      placeholder: |
+        1. Do this...
+        2. Do that...
+        ...
+    validations:
+      required: true
+
+  - type: input
+    id: project-version
+    attributes:
+      label: "Project Version"
+      description: "The version of the project where this issue occurred."
+      placeholder: "0.1.5, a7df908, username/issue-branch, ..."
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: os
+    attributes:
+      label: "The OS/Variant where this issue occurs."
+      description: "If \"Other\" is selected, please provide the additional OS in the \"Additional Context\" section."
+      options:
+        - label: "iOS"
+        - label: "macOS"
+        - label: "tvOS"
+        - label: "watchOS"
+        - label: "Mac Catalyst"
+        - label: "Other (Please specify in \"Additional Context\" section)"
+    validations:
+      required: true
+
+  - type: input
+    id: xcode-version
+    attributes:
+      label: "The version of Xcode that was used when this issue appeared."
+      placeholder: "12.1.1, 13.0 Beta 4, Build 13A1030d, ..."
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: environment
+    attributes:
+      label: "What was the environment in which the issue appeared?"
+      options:
+        - label: "CBORCoding.xcodeproj"
+        - label: "Package.swift"
+        - label: "Carthage"
+        - label: "CocoaPods"
+        - label: "Swift Package Manager"
+        - label: "Other (Please specify in \"Additional Context\" section)"
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: "Additional Context"
+      description: |
+        Add any other context about the problem (e.g. screenshots, links, logs, references, sample projects, etc.)
+
+        Tip: You can attach files here by clicking this area to highlight it and then dragging files in.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/FEATURE_REQUEST.yml

@@ -0,0 +1,55 @@
+name: Feature Request
+description: Suggest your awesome idea for this project!
+title: "[FEATURE]: "
+labels: ["enhancement"]
+assignees:
+  - SomeRandomiOSDev
+
+body:
+  - type: markdown
+    attributes:
+      value: "Thanks for taking the time to fill out this feature request!"
+
+  - type: textarea
+    id: existing-problem
+    attributes:
+      label: "Is your feature request related to a problem?"
+      description: "A clear and concise description of what the problem is."
+      placeholder: "e.g. I'm already frustrated when [...]"
+    validations:
+      required: false
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: "Describe the solution you'd like."
+      placeholder: "e.g It would be a lot better if [...]"
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: "Describe alternatives you've considered."
+    validations:
+      required: false
+
+  - type: input
+    id: current-progress
+    attributes:
+      label: "Have you already worked out some solution or have a PoC?"
+      description: "Please provide the repo where we can find your work."
+      placeholder: "e.g. username/partial-solution"
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: "Additional Context"
+      description: |
+        Add any other context about the feature request here (e.g. screenshots, links, references, sample projects, etc.)
+
+        Tip: You can attach files here by clicking this area to highlight it and then dragging files in.
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,32 @@
+# Pull Request Process
+
+## Before submitting a pull request
+
+Please review the [guidelines for contributing](../CONTRIBUTING.md) to this repository and remove this and all lines above this one prior to submitting your `pull request`.
+
+## Description
+
+A brief description of your `pull request`.
+
+## Checklist
+
+Ensure that your `pull request` has followed all the steps below:
+
+* [ ] Code compilation.
+* [ ] All tests passing.
+* [ ] No new SwiftLint issues.
+* [ ] Added new unit tests, if applicable.
+* [ ] Extended the documentation (including README), if applicable.
+* [ ] Updated version in CBORCoding.podspec following [semver](https://semver.org) guidelines.
+* [ ] Ran [workflowtests.sh](../../scripts/workflowtests.sh) and passed.
+* [ ] Added myself to the [CONTRIBUTORS](../CONTRIBUTORS.md) file.
+
+## Proposed changes
+
+A detailed explaination of your changes and why these should be added to this project. 
+
+If this is related to one or more [issues](https://github.com/SomeRandomiOSDev/CBORCoding/issues), please add `closes #XXXX` (or any other [acceptable notation](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)) to link this pull request to them.
+
+## Additional Info
+
+Any other relevant information that needs to be known about this `pull request` (e.g. "tvOS 14.0 and up", "Requires Xcode 13", etc.).