diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..e9cf4d7 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,28 @@ +# Contributing + +If you'd like to contribute, welcome!! We are so glad you are here. We hope you will take a moment to read our [code of conduct](../code-of-conduct.md) before continuing. + + + +- [Documentation repository](https://git.lollipopcloud.solutions/lollipop-cloud/docs) +- [Code repository](https://git.lollipopcloud.solutions/lollipop-cloud/lolipop_lan_cloud) +- [Docker-specific repositories](https://git.lollipopcloud.solutions/lollipop-docker/misc) + +Lowering the barrier for contributions is important: we value your input, regardless of your level of experience or area of expertise. If you would rather [contact us directly](https://lollipopcloud.solutions/page/contact/), please do not hesitate to reach out through email or chat. + +Note: by submitting a PR, you agree to your contribution(s) being licensed as described in our [LICENSE.md](../LICENSE.md). + +## Documentation + +**In order to ease the process of reading and applying docs, please:** + +* Add an introduction for what the documentation is about (1-2 short paragraphs should suffice) before presenting links, code, etc., for the sake of context; +* Use plain language, because our users are diverse with a wide range of technical and non-technical backgrounds; +* Don't abbreviate or assume something is banal/easy/common knowledge (define acronyms on first use); +* Be specific, even when you believe "everyone knows this." + +**For extra readability purposes:** + +* Use markdown, if possible, for different areas/topics among the doc, as well as plenty of white space; +* Separate configurations/commands from explanations with a code block (triple backtick). +* If you can't explain a "basic concept" in a easy way without making a wall of text in the middle of your doc, feel free to hyperlink to separate documentation where those concepts are already explained, be it Wikipedia or another doc that has high readability and reliability. diff --git a/contributing/sosasa-kanban.md b/attic/contributing/sosasa-kanban.md similarity index 90% rename from contributing/sosasa-kanban.md rename to attic/contributing/sosasa-kanban.md index f3a0c68..fdd62c2 100644 --- a/contributing/sosasa-kanban.md +++ b/attic/contributing/sosasa-kanban.md @@ -1,3 +1,5 @@ +*This document has been archived. The SOSASA modified kanban approach was an integral part of the early days of the Lollipop project, and we leave it here as a resource for future projects and organizations looking for a contribution management system that's less developer oriented. As always, if you're interested in contributing to the Lollipop project and are not technically oriented, you can always reach out to us in the method most comfortable for you. We keep the contact page on our website up to date for such purposes.* + # The Lollipop Cloud Project's Issue Reporting and Feature Requesting Process ## Definitions diff --git a/contributing/CONTRIBUTING.md b/contributing/CONTRIBUTING.md deleted file mode 100644 index 76e3c04..0000000 --- a/contributing/CONTRIBUTING.md +++ /dev/null @@ -1,34 +0,0 @@ -# Contributing -We use a modified kanban methodology called SOSASA (Structuring your project for the purposes Of Social Activism and Accessibility) for contributions. You can read about [our adaptation of SOSASA here (link)](sosasa-kanban.md), and creator hoodie aida kitten's complete onboarding article and [detailed SOSASA description here (link)](https://medium.com/@novemberninerniner/the-lifetime-of-an-issue-feature-request-f0ae1210e8c2). - -If you'd like to contribute, welcome!! We are so glad you are here. We hope you will take a moment to read our [code of conduct (link)](../code-of-conduct.md) before continuing. - -To contribute, please read [our adaptation of SOSASA here (link)](sosasa-kanban.md), which contains more detail about how you can contribute, then join our [kanban boards (link)](https://kanban.lollipopcloud.solutions/) by signing up for an account and logging in. - -* For documentation contributions, we have a [kanban board for documentation (link)](https://kanban.lollipopcloud.solutions/project/admin-lollipop-documentation/kanban/). - -* For code-related contributions, we have a [kanban board for code (link)](https://kanban.lollipopcloud.solutions/project/admin-lollipop-cloud/kanban/) - -...to read and comment on anything you see, or create a new issue by clicking the `+` sign at the top of the `Brainstorming` column. - -If you already have code or documentation to contribute, our [documentation repository is here (link)](https://git.lollipopcloud.solutions/lollipop-cloud/docs) and our [code repo is here (link)](https://git.lollipopcloud.solutions/lollipop-cloud/lolipop_lan_cloud). - -Lowering the barrier for contributions is important: we value your input, regardless of your level of experience or area of expertise. If you would rather [contact us directly (link)](https://lollipopcloud.solutions/page/contact/), please do not hesitate to reach out through email or chat. We can also provide assistance walking you through our contribution process if you'd like to learn SOSASA or Gitea. - -Note: by submitting a PR, you agree to your contribution(s) being licensed as described in our [LICENSE.md (link)](../LICENSE.md). - -## Documentation - -**In order to ease up the process of reading and applying docs, please:** - -* Add an intro to what the documentation is about (a couple of paragraphs should suffice) before presenting links, code, etc., for the sake of context - especially to the non-initiated; -* Make very clear what each step is and use language that anyone would understand (KISS); -* Don't abbreviate or assume something is banal/easy/common knowledge; -* Be specific even when it sounds like it's something everyone knows about. - Example of something that should be specified in docs: where to implement the stuff you just wrote about; - -**For extra readability purposes:** - -* Use markdown, if possible, for different areas/topics among the doc (text vs code, for example), as well as space; -* Break apart config/commands from docs. -* If you can't explain a "basic concept" in a easy way without making a wall of text in the middle of your doc, feel free to hyperlink to other documentation where those concepts are already explained, be it Wikipedia or another doc online that has high readability and reliability; diff --git a/contributing/README.md b/contributing/README.md deleted file mode 100644 index 9da9573..0000000 --- a/contributing/README.md +++ /dev/null @@ -1,8 +0,0 @@ -# Welcome! - -We welcome your contributions! - -- [Read more about contribution guidelines here (link)](CONTRIBUTING.md) -- [Read more about SOSASA, our modified kanban approach here (link)](sosasa-kanban.md) -- [Our code of conduct is here (link)](../code-of-conduct.md) -- If you're new to Git or Gitea, check out our ["how to gitea" documentation (link)](../for-beginners/how-to-gitea.md).