diff --git a/.gitbook/assets/11 (2).png b/.gitbook/assets/11 (2).png new file mode 100644 index 00000000..eeac585b Binary files /dev/null and b/.gitbook/assets/11 (2).png differ diff --git a/.gitbook/assets/7 (1) (2).png b/.gitbook/assets/7 (1) (2).png new file mode 100644 index 00000000..5a096242 Binary files /dev/null and b/.gitbook/assets/7 (1) (2).png differ diff --git a/.gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (2).png b/.gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (1) (1).png similarity index 100% rename from .gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (2).png rename to .gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (1) (1).png diff --git a/.gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (1) (2).png b/.gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (1) (2).png new file mode 100644 index 00000000..bf0ae1db Binary files /dev/null and b/.gitbook/assets/7 (2) (2) (2) (2) (2) (2) (2) (2) (1) (2).png differ diff --git a/.gitbook/assets/9 (2).png b/.gitbook/assets/9 (2).png new file mode 100644 index 00000000..ba6d21d6 Binary files /dev/null and b/.gitbook/assets/9 (2).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (10).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (10).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (10).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (11).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (11).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (11).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (12).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (12).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (12).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (13).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (13).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (13).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (14).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (14).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (14).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (15).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (15).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (15).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (16).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (16).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (16).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (17).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (17).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (17).png differ diff --git a/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (18).png b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (18).png new file mode 100644 index 00000000..a716f782 Binary files /dev/null and b/.gitbook/assets/about_terminology_individual_2019-07-09 (2) (18).png differ diff --git a/.gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (2).png b/.gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (1) (1).png similarity index 100% rename from .gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (2).png rename to .gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (1) (1).png diff --git a/.gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (1) (2).png b/.gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (1) (2).png new file mode 100644 index 00000000..35816d5a Binary files /dev/null and b/.gitbook/assets/about_terminology_organization_2019-07-09 (1) (2) (2) (2) (2) (2) (2) (2) (1) (2).png differ diff --git a/.gitbook/assets/collectives_opensourcecollectives_manual_2021-06-18.png b/.gitbook/assets/collectives_opensourcecollectives_manual_2021-06-18.png new file mode 100644 index 00000000..1c691ba9 Binary files /dev/null and b/.gitbook/assets/collectives_opensourcecollectives_manual_2021-06-18.png differ diff --git a/.gitbook/assets/financial_contributions_receipts_payment_receipts_2021-06-17.png b/.gitbook/assets/financial_contributions_receipts_payment_receipts_2021-06-17.png new file mode 100644 index 00000000..a52e9ef6 Binary files /dev/null and b/.gitbook/assets/financial_contributions_receipts_payment_receipts_2021-06-17.png differ diff --git a/.gitbook/assets/financial_contributions_receipts_settings_2021-06-17.png b/.gitbook/assets/financial_contributions_receipts_settings_2021-06-17.png new file mode 100644 index 00000000..0db1d8d9 Binary files /dev/null and b/.gitbook/assets/financial_contributions_receipts_settings_2021-06-17.png differ diff --git a/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (1).png b/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (1).png new file mode 100644 index 00000000..46cdaa7c Binary files /dev/null and b/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (1).png differ diff --git a/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (2).png b/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (2).png new file mode 100644 index 00000000..46cdaa7c Binary files /dev/null and b/.gitbook/assets/fiscal-host (2) (2) (2) (2) (2) (2) (2) (2) (2).png differ diff --git a/.gitbook/assets/fiscal-hosts_open-source-collective_search-bar-pick-a-repo_2019-10-28 (2).gif b/.gitbook/assets/fiscal-hosts_open-source-collective_search-bar-pick-a-repo_2019-10-28 (2).gif new file mode 100644 index 00000000..c3e17361 Binary files /dev/null and b/.gitbook/assets/fiscal-hosts_open-source-collective_search-bar-pick-a-repo_2019-10-28 (2).gif differ diff --git a/.gitbook/assets/image (16) (2).png b/.gitbook/assets/image (16) (2).png new file mode 100644 index 00000000..def1a239 Binary files /dev/null and b/.gitbook/assets/image (16) (2).png differ diff --git a/.gitbook/assets/screen-shot-2019-05-23-at-1.01.51-pm (2) (2) (2) (2) (1) (3).png b/.gitbook/assets/screen-shot-2019-05-23-at-1.01.51-pm (2) (2) (2) (2) (1) (3).png new file mode 100644 index 00000000..606f0fdf Binary files /dev/null and b/.gitbook/assets/screen-shot-2019-05-23-at-1.01.51-pm (2) (2) (2) (2) (1) (3).png differ diff --git a/README.md b/README.md index dd2c8c9b..1f3dd664 100644 --- a/README.md +++ b/README.md @@ -88,11 +88,11 @@ You've come to the right place! These docs explain the whole platform in detail. ### How can I contact you? -Email [support@opencollective.com](mailto:support@opencollective.com) or join our [Slack](https://slack.opencollective.com)! +Contact us at [support@opencollective.com](mailto:support@opencollective.com) or join our [Slack](https://slack.opencollective.com)! ### How can I contribute? -We are an open source project and run as an Open Collective ourselves. You can contribute [money](https://opencollective.com/opencollectiveinc), [code](contributing/development/) or [translations](contributing/translation.md). And we'd really love it if you [started your own Collective](https://opencollective.com/create) and contributed by growing the community! +We are an open source project and run as an Open Collective ourselves. You can contribute [money](https://opencollective.com/opencollective/donate), [code](contributing/development/) or [translations](contributing/translation.md). And we'd really love it if you [started your own Collective](https://opencollective.com/create) and contributed by growing the community! For more info about how you can contribute to Open Collective, check the [contributing page](about/contributing.md). diff --git a/SUMMARY.md b/SUMMARY.md index 85c57bc9..ce5182f9 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -67,6 +67,7 @@ * [Guest contributions](financial-contributors/guest-contributions.md) * [Payments](financial-contributors/payments.md) * [Website Badge](financial-contributors/website-badge.md) +* [Receipts](financial-contributors/receipts.md) * [Collective to Collective](financial-contributors/collective-to-collective.md) * [Organizations](financial-contributors/organizations/README.md) * [FAQ](financial-contributors/organizations/organization-faq.md) @@ -106,7 +107,6 @@ * [Host Fees](fiscal-hosts/fiscal-host-fees.md) * [Local Tax Support](fiscal-hosts/local-tax.md) * [Agreement Templates](fiscal-hosts/sponsor-agreement.md) -* [Open Source Collective](fiscal-hosts/open-source-collective.md) ## Contributing diff --git a/about/company.md b/about/company.md index ea7f8184..14335efa 100644 --- a/about/company.md +++ b/about/company.md @@ -8,7 +8,7 @@ We are a US based C corp registered in Delaware. We also have created other sepa ### Where are you based? -Our team is distributed between Aix-en-Provence, Auckland, Brussels, Berlin, Guadalajara, New York, Madrid, Paris, Shropshire, Navi Mumbai, Vancouver and Wellington. +Our team is distributed between Aix-en-Provence, Auckland, Brussels, Berlin, Guadalajara, New York, Madrid, Paris, Shropshire, Navi Mumbai, Vancouver and Wellington. ### When did you start? @@ -24,5 +24,5 @@ We try to be very transparent about our own finances. We raised a total of $2,81 ### How do I get in touch with you? -Email support@opencollective.com or join our [Slack](https://slack.opencollective.com/). +Contact us at [https://opencollective.com/support](https://opencollective.com/support) or join our [Slack](https://slack.opencollective.com/). diff --git a/about/contributing.md b/about/contributing.md index 2a1daf5e..779ec556 100644 --- a/about/contributing.md +++ b/about/contributing.md @@ -30,7 +30,7 @@ Suggest changes to this documentation! ## **Marketing** -Write blog posts and share success stories! We offer a $100 blog bounty to any Collective who wants to tell their story. Just reach out to [support@opencollective.com](mailto:support@opencollective.com) if you're interested. +Write blog posts and share success stories! We offer a $100 blog bounty to any Collective who wants to tell their story. Just reach out to [https://opencollective.com/support](https://opencollective.com/support) if you're interested. ## **Design** diff --git a/about/introduction.md b/about/introduction.md index a230cbd3..aa0b688f 100644 --- a/about/introduction.md +++ b/about/introduction.md @@ -10,9 +10,9 @@ This is the problem which Open Collective solves. We enable groups to quickly se We want all those seeds to have a chance to grow and give the ideas a fighting chance to reach their true potential. We believe everyone should have the tools to create the organizations of tomorrow. And we are dedicating ourselves to make that happen! -Contact us: info@opencollective.com +Contact us: [info@opencollective.com](mailto:info@opencollective.com) -Support: support@opencollective.com +Support: [https://opencollective.com/support](https://opencollective.com/support) ## Essays @@ -84,5 +84,7 @@ Additionally, regulations are different all over the world. Our platform is the ### **Why not use the Blockchain and Cryptocurrency?** -We're excited about the new possibilities these technologies are creating, and we'd love to explore how they could help us achieve our goals. But just like we won't wait for self-driving cars to become ubiquitous before calling a Lyft, we're very practical about using existing services to solve problems right now. We can already get pretty far using well-established technologies already integrated with global systems. That said, we are actively exploring how to support cryptocurrency on the platform, so if you're interested in that, get in in touch. +We're excited about the new possibilities these technologies are creating, and we'd love to explore how they could help us achieve our goals. But just like we won't wait for self-driving cars to become ubiquitous before calling a Lyft, we're very practical about using existing services to solve problems right now. We can already get pretty far using well-established technologies already integrated with global systems. That said, we are actively exploring how to support cryptocurrency on the platform, so if you're interested in that, get in touch. + +~~~~ diff --git a/about/terminology.md b/about/terminology.md index 046ab6c5..13ee2916 100644 --- a/about/terminology.md +++ b/about/terminology.md @@ -29,7 +29,7 @@ Individual\(s\) who create and/or manage the Organization profile. They have rig **Funds** -A [Fund](%20https://docs.opencollective.com/help/financial-contributors/organizations/funds), with a capital F, \(as opposed to a [Collective](terminology.md#user)\) is a streamlined, single payer process for supporters. A **Fund** is likely less interested in the 'social' & crowdfunding aspects of fundraising. This type of account will have a more simplified version of our dashboard for those who don't want all the extra features that group-organizing benefits from. +A [Fund](https://github.com/opencollective/documentation/tree/1b6b2a20534e35ca28433008c25dfde7a0e386fa/help/financial-contributors/organizations/funds/README.md), with a capital F, \(as opposed to a [Collective](terminology.md#user)\) is a streamlined, single payer process for supporters. A **Fund** is likely less interested in the 'social' & crowdfunding aspects of fundraising. This type of account will have a more simplified version of our dashboard for those who don't want all the extra features that group-organizing benefits from. ### Fiscal Hosts ![](../.gitbook/assets/fiscal-host%20%282%29%20%282%29%20%282%29%20%282%29%20%282%29%20%282%29%20%282%29%20%281%29.png) @@ -94,7 +94,7 @@ They arrive at a Collective many ways: * Direct link to a Collective * [Github badges on README](../financial-contributors/website-badge.md) * Organization's page -* [BackYourStack](https://www.backyourstack.com) +* [BackYourStack](https://backyourstack.com) * Our [blog](https://blog.opencollective.com) or newsletter #### Expense submitter diff --git a/about/the-open-collective-way/community-guidelines-1.md b/about/the-open-collective-way/community-guidelines-1.md index 5cc66fc1..bf18e6e6 100644 --- a/about/the-open-collective-way/community-guidelines-1.md +++ b/about/the-open-collective-way/community-guidelines-1.md @@ -1,10 +1,10 @@ # Community Guidelines -**We are a community based on trust, transparency, and contribution. In order to keep it that way, we expect everyone to act in accordance with these guidelines, including all Collectives, Backers, Sponsors, and our own Open Collective team.**. +**We are a community based on trust, transparency, and contribution. In order to keep it that way, we expect everyone to act in accordance with these guidelines, including all Collectives, Backers, Sponsors, and our own Open Collective team.** ## **Be Authentic** -Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. _\*\*_We're all in this together, please act respectfully, honestly, and mission-aligned when using our site. +Participate in an authentic and active way. In doing so, you contribute to the health and longevity of this community. We're all in this together, please act respectfully, honestly, and mission-aligned when using our site. ## **Be honest** @@ -36,7 +36,7 @@ To sponsors, collective members are often volunteers taking time away from their If something is wrong, let us know. We believe in self-managing systems, so we do not police or moderate excessively. The only way this works is by sharing the effort of noticing what is going on. -While we give you tools to moderate interactions with your collective, we still rely on you to let us know when something isn’t right. Please contact us any time: [support@opencollective.com](mailto:support@opencollective.com). +While we give you tools to moderate interactions with your collective, we still rely on you to let us know when something isn’t right. Please contact us any time: [https://opencollective.com/support](https://opencollective.com/support). ## **Share the love** diff --git a/about/the-open-collective-way/core-contributors-compensation.md b/about/the-open-collective-way/core-contributors-compensation.md index 944b7661..6d4c93af 100644 --- a/about/the-open-collective-way/core-contributors-compensation.md +++ b/about/the-open-collective-way/core-contributors-compensation.md @@ -7,7 +7,7 @@ ## **Open Collective Engineering** -The engineering team \(François, Ben, Leo, Kate\) started to use a public formula for compensation: [https://docs.google.com/spreadsheets/d/1TvdgSmFbfB6Cj8vnWm01v7wZmo42QpcSvCK8tgIzDW0/edit\#gid=165029136](https://docs.google.com/spreadsheets/d/1TvdgSmFbfB6Cj8vnWm01v7wZmo42QpcSvCK8tgIzDW0/edit#gid=165029136) +The engineering team \(François, Ben, Leo, Sudharaka\) use a public formula for compensation: [https://docs.google.com/spreadsheets/d/1TvdgSmFbfB6Cj8vnWm01v7wZmo42QpcSvCK8tgIzDW0/edit\#gid=165029136](https://docs.google.com/spreadsheets/d/1TvdgSmFbfB6Cj8vnWm01v7wZmo42QpcSvCK8tgIzDW0/edit#gid=165029136) In addition to this, every engineer in the team is granted a $100 monthly gift card to contribute to the projects of their choice. diff --git a/about/the-open-collective-way/core-contributors-expenses.md b/about/the-open-collective-way/core-contributors-expenses.md index 25ffdf0a..61cbb49a 100644 --- a/about/the-open-collective-way/core-contributors-expenses.md +++ b/about/the-open-collective-way/core-contributors-expenses.md @@ -14,7 +14,7 @@ **Core contributors \(& part time contributors\) should submit their invoices to the corresponding collective:** -* opencollective.com/opencollective -* opencollective.com/design -* opencollective.com/engineering +* [opencollective.com/opencollective](https://opencollective.com/opencollective) +* [opencollective.com/design](https://opencollective.com/design) +* [opencollective.com/engineering](https://opencollective.com/engineering/) diff --git a/about/the-open-collective-way/core-contributors-guidelines.md b/about/the-open-collective-way/core-contributors-guidelines.md index 6c1928e1..d0087aee 100644 --- a/about/the-open-collective-way/core-contributors-guidelines.md +++ b/about/the-open-collective-way/core-contributors-guidelines.md @@ -33,5 +33,5 @@ Ensure you have **proper RFCs** for important changes * Does this increase quality and not technical debt? * Will this bring us more Collective and financial contributors? * Is this already solved elsewhere or is it our unique contribution? -* Can we measure the success of this? +* Can we measure the success of this? diff --git a/collectives/budget.md b/collectives/budget.md index 05df0315..8d85ddca 100644 --- a/collectives/budget.md +++ b/collectives/budget.md @@ -52,7 +52,7 @@ Open the “RAW FILE” tab inside the file. ![](https://paper-attachments.dropbox.com/s_D19E76E8026880734906183F5F67A13D8F5770AC8212DCC2B79CE9738C72C087_1565983068990_Schermata+2019-08-16+alle+14.16.44.png) -You will see something like this: _\*\*_Now, you will have to do some tweaks to the data before we can use it… +You will see something like this: \_\*\*\_Now, you will have to do some tweaks to the data before we can use it… ![](https://paper-attachments.dropbox.com/s_D19E76E8026880734906183F5F67A13D8F5770AC8212DCC2B79CE9738C72C087_1565983259029_Schermata+2019-08-16+alle+14.20.15.png) @@ -86,8 +86,7 @@ Since the dates of the file run from newest to oldest, it’s better to invert t ### Copy and paste values in the template -Select all values except the With cell A6 selected:Right click → “Paste special” → “Paste values only” -**Voilà!**You will have your totals for expenses and contributions into a nice and visible balance chart. Plus individual transactions sorted by date and differentiated by color codes. +Select all values except the With cell A6 selected: Right click → “Paste special” → “Paste values only”. **Voilà!** You will have your totals for expenses and contributions into a nice and visible balance chart. Plus individual transactions sorted by date and differentiated by color codes. ![](https://paper-attachments.dropbox.com/s_D19E76E8026880734906183F5F67A13D8F5770AC8212DCC2B79CE9738C72C087_1566167201844_Screen+Shot+2019-08-18+at+17.26.30.png) diff --git a/collectives/communication.md b/collectives/communication.md index bdfe494a..5196a922 100644 --- a/collectives/communication.md +++ b/collectives/communication.md @@ -8,8 +8,6 @@ To create an Update, go to your Collective page, head to the **Updates** section ![](../.gitbook/assets/collectives_updates-and-comms_create-new-update.png) - - #### Target audience If you're a fiscal host, you'll have the option to pick the target audience before publishing an update: @@ -48,7 +46,7 @@ And if you wish, you can set it to become public after a certain date. ## Contacting a Collective -Users can contact you via the contact form of your collective. It is linked in your collective page through the `Contact` button. The forms stands on `/{your-collective}/contact`. If you don't want to use this feature, please email us at `support@opencollective.com` and we'll disable it for you. +Users can contact you via the contact form of your collective. It is linked in your collective page through the `Contact` button. The forms stands on `/{your-collective}/contact`. If you don't want to use this feature, please contact us at [https://opencollective.com/support](https://opencollective.com/support) and we'll disable it for you. ![](../.gitbook/assets/image%20%2820%29.png) diff --git a/collectives/connectedcollectives.md b/collectives/connectedcollectives.md index 7782547b..f9bd90f6 100644 --- a/collectives/connectedcollectives.md +++ b/collectives/connectedcollectives.md @@ -1,7 +1,7 @@ # Connected Collectives {% hint style="info" %} -Creating connected collectives is [a manual process](../internal/queries/connectedcollective-queries.md) at the moment. If you want to do it, please send an email to [support@opencollective.com](mailto:support@opencollective.com) describing what you'd like. +Creating connected collectives is [a manual process](../internal/queries/connectedcollective-queries.md) at the moment. If you want to do it, please contact us at [https://opencollective.com/support](https://opencollective.com/support) describing what you'd like. {% endhint %} Connected collectives are a way to display the different collectives or local projects that came out of your main initiative. Collectives are not strongly tied together: diff --git a/collectives/customize-collective.md b/collectives/customize-collective.md index 273c56fb..639acedd 100644 --- a/collectives/customize-collective.md +++ b/collectives/customize-collective.md @@ -2,13 +2,13 @@ ## Edit Settings -To access all settings for your Collective, click the settings button shown in the image below. +To access all settings for your Collective, click the settings button shown in the image below. ![](../.gitbook/assets/collectives_customize_collective_2021-05-31.png) ## Page Sections -As an admin, all sections will appear in your view, with invitations to add content. However, any sections without content in will not appear to other users \(for example, **Updates** and **About**\). +As an admin, all sections will appear in your view, with invitations to add content. However, any sections without content will not appear to other users \(for example, **Updates** and **About**\). ![](../.gitbook/assets/screen-shot-2019-09-18-at-11.12.02-am.png) @@ -32,7 +32,7 @@ Click on **Edit main color** in the header area to set the color. ## Set Cover Image -To change your cover image, click on **Edit cover**. By clicking on the image, you are able to move it around. You can also zoom in and out as you like. +To change your cover image, click on **Edit cover**. By clicking on the image, you are able to move it around. You can also zoom in and out as you like. The optimal image size for a cover image is 2736x650. ![](../.gitbook/assets/cover-image.gif) diff --git a/collectives/events.md b/collectives/events.md index d3ea1cc9..d5939515 100644 --- a/collectives/events.md +++ b/collectives/events.md @@ -18,7 +18,6 @@ Log in to your Collective and scroll down to the Events section. Click on the ** ![](../.gitbook/assets/collectives_events_creating-a-event.png) -* **Template:** if it's your first event, select no template. If you want to copy a previous event, select it. * **URL:** the online address your event will have - very important so you don't get a [404 error](events.md#i-cant-see-my-event-listed-or-get-a-404-error). * **Name** of the event * **Description:** purpose, schedule, etc @@ -62,7 +61,7 @@ To delete, scroll down to the bottom and click "delete event". ## I can't see my event listed or get a 404 error -You probably forgot to set the URL field when creating the event. Just write to us at [support@opencollective.com](mailto:support@opencollective.com) and we will fix it. Sorry for the inconvenience this may cause you—we are working on improving this. +You probably forgot to set the URL field when creating the event. Just write to us at [https://opencollective.com/support](https://opencollective.com/support) and we will fix it. Sorry for the inconvenience this may cause you—we are working on improving this. ## Email Attendees diff --git a/collectives/github-sponsors.md b/collectives/github-sponsors.md index fd3b0748..b477aa4d 100644 --- a/collectives/github-sponsors.md +++ b/collectives/github-sponsors.md @@ -1,22 +1,28 @@ -# Setting up GitHub Sponsors - -**This document is a guide to connecting Github Sponsors for Organizations to your Collective. This option is currently only available for Collectives fiscally hosted by the** [**Open Source Collective**](https://opencollective.com/opensource) **\(not Open Collective Europe or other fiscal hosts\), which will hold the funds on behalf of your project.** +--- +description: Guide to connecting Github Sponsors for Organizations to your Collective +--- -_Note: Transaction data about the funds you receive through GitHub Sponsors will be shared with Open Source Collective in order to credit your budget._ +# Setting up GitHub Sponsors {% hint style="warning" %} -This guide is **only** for projects using **Open Source Collective** as their fiscal host. Before signing up using this guide, confirm that your Collective has a fiscal host, and the fiscal host is **Open Source Collective**. You can see this on your Collective's home page: +This guide is **only** for projects using [**Open Source Collective**](https://opencollective.com/opensource) as their fiscal host. Before signing up using this guide, confirm that your Collective has a fiscal host, and the fiscal host is **Open Source Collective**. You can see this on your Collective's home page: ![](../.gitbook/assets/sponsors-fiscal-host.png) If you have another fiscal host you will need to choose Fiscal Host: Other when signing up for GitHub Sponsors and work with your fiscal host to get their bank account and tax information. {% endhint %} +_Note: Transaction data about the funds you receive through GitHub Sponsors will be shared with Open Source Collective in order to credit your budget._ + Open Source Collective projects can use Open Collective to receive GitHub Sponsors funds by following these steps: 1. Confirm that you have a **GitHub organization** \(not an individual user account\). You can create a GitHub organization by following [this guide](https://help.github.com/en/github/setting-up-and-managing-organizations-and-teams/creating-a-new-organization-from-scratch). -2. [Create a Collective](https://opencollective.com/opensource/apply) for your open source project if you don't already have one. You will need to use Open Source Collective as your fiscal host. _Note: Open Collective also has a thing called "Organizations" but this is unrelated. You need an Organization on the GitHub side and a Collective on the Open Collective side. Sorry for the confusing terms!_ -3. Visit [github.com/sponsors](http://github.com/sponsors) and sign your Github organization up for the Sponsors waitlist. ✔️ Select: "This organization is using a fiscal host" and select Open Source Collective from the menu. ✔️ For non-profit status, answer: “Yes, this organization has nonprofit status but cannot receive tax-deductible donations from individuals \(e.g., 501c6\)” +2. [Create a Collective](https://opencollective.com/opensource/apply) for your open source project if you don't already have one. You will need to use [Open Source Collective](https://opencollective.com/opensource) as your fiscal host. _Note: Open Collective also has a thing called "Organizations" but this is unrelated. You need an Organization on the GitHub side and a Collective on the Open Collective side._ +3. Visit [github.com/sponsors](http://github.com/sponsors) and sign your Github organization up for the Sponsors waitlist. + +✔️ Select: "This organization is using a fiscal host" and select Open Source Collective from the menu. + +✔️ For non-profit status, answer: “Yes, this organization has nonprofit status but cannot receive tax-deductible donations from individuals \(e.g., 501c6\)” ![](../.gitbook/assets/screen-shot-2020-08-30-at-4.07.15-pm.png) @@ -94,7 +100,7 @@ Confusingly, GitHub and Open Collective use the word "organization" to mean two ### What if Stripe asks for KYC info? -Sometimes Stripe will ask for extra info as part of their normal security protocols. If this happens, you can provide Open Source Collective's organizational info as described above. +Sometimes Stripe will ask for extra info as part of their normal security protocols. If this happens, you can provide Open Source Collective's organizational info as described above. -The address for KYC purposes is the same: 340 S LEMON AVE \#3717, Walnut CA 91789 USA. If they ask for anything you don't know the answer to, please contact support@opencollective.com. +The address for KYC purposes is the same: 340 S LEMON AVE \#3717, Walnut CA 91789 USA. If they ask for anything you don't know the answer to, please contact [https://opencollective.com/support](https://opencollective.com/support). diff --git a/collectives/integrations.md b/collectives/integrations.md index 56a9be66..68e7137c 100644 --- a/collectives/integrations.md +++ b/collectives/integrations.md @@ -20,7 +20,7 @@ When adding a discord webhook, make sure to use the [Slack-compatible](https://d ## Other chat integrations \(Mattermost, Gitter\) -For Mattermost or Gitter, first set up a webhook as described above, and then [send it to us](mailto:support@opencollective.com) and we'll add the hook to our platform. +For Mattermost or Gitter, first set up a webhook as described above, and then [send it to us](https://opencollective.com/support) and we'll add the hook to our platform. ## Twitter Integration diff --git a/collectives/moderation.md b/collectives/moderation.md index 5f003125..d1db9bf2 100644 --- a/collectives/moderation.md +++ b/collectives/moderation.md @@ -25,7 +25,7 @@ Click 'Yes, reject' and then the status of the transaction should update in your ![](../.gitbook/assets/screenshot-2020-10-16-at-10.40.34.png) {% hint style="danger" %} -If an account continues to make contributions to your Collective after you have rejected them, this is against Open Collective's community guidelines. Please get in touch with[ support@opencollective.com](mailto:support@opencollective.com) and we can block the account from interacting with your Collective. +If an account continues to make contributions to your Collective after you have rejected them, this is against Open Collective's community guidelines. Please get in touch with [https://opencollective.com/support](https://opencollective.com/support) and we can block the account from interacting with your Collective. {% endhint %} ## Rejecting categories of financial contributors @@ -60,6 +60,6 @@ If a contributor's account has been tagged by the Open Collective team as belong If you would like to let potential contributors to your Collective know upfront what your **contribution policy** is, and what kinds of contributions you may not accept, you can also do this in the _'Policies'_ section of the Collective menu. This will be displayed in the contribution flow as well. {% hint style="danger" %} -It is against Open Collective's community guidelines and moderation policy for a contributor to create a new account to get around the category filter. If this happens, please report it to us at [support@opencollective.com](mailto:support@opencollective.com) +It is against Open Collective's community guidelines and moderation policy for a contributor to create a new account to get around the category filter. If this happens, please report it to us on [https://opencollective.com/support](https://opencollective.com/support) {% endhint %} diff --git a/collectives/osc-verification.md b/collectives/osc-verification.md index 7d18957b..7584bc74 100644 --- a/collectives/osc-verification.md +++ b/collectives/osc-verification.md @@ -1,9 +1,27 @@ --- -description: For the applying to the Open Source Collective +description: To apply to the Open Source Collective --- # Open Source Collectives +We have created a non-profit, the Open Source Collective 501c6 in the United States to act as a fiscal sponsor to host all open source projects. This makes it easy for companies to donate to your project since they can receive one consolidated invoice. + +### What services does the Open Source Collective provide? + +This host organization provides invoices and request for funds for your sponsors, onboards as a vendor in their system, receives bulk payments, manages relevant tax forms and checkout processes from other revenue streams \(like Threadless, carbon ads and affiliate programs\). + +### What is the cost? + +The Open Source Collective 501c6 takes a fee of 10%. This is to cover the administrative overhead, accounting, legal. That way you never have to worry about all that boring stuff and you can focus on your project. + +### What are the Terms of Fiscal Sponsorship? + +You can find them [here](https://docs.google.com/document/u/1/d/1HRYVADHN1-4B6wGCxIA6dx28jHtcAVIvt95hkjEZVQE/pub) + +### How do I apply? + +If you think this works for you, go ahead and create your collective selecting **For open source projects** in [opencollective.com/create](https://opencollective.com/create) to apply to this host. If you'd rather become your own host, select **For any community**, and you'll be able to set up your own host in the process. Note that in that case, you will be responsible for doing the accounting as well as facilitating payments from sponsors. + ## What is Github Stars Verification? Open Source Collective offers the option to verify your Collective by showing that it has at least 100 Github stars. Meeting this requirement can expedite approval of your Collective. @@ -16,12 +34,6 @@ If your project is not centered on a Github repository, or you can't get the aut ## Github Verification Troubleshooting -### The permissions you ask for are overly generous and my organization doesn't want to grant them. - -We agree the permissions are overly generous. Unfortunately, there's not much we can do at the moment since this is the only scope we can use to read the info we need. We've discussed this at length on issues [\#355](https://github.com/opencollective/opencollective/issues/355), [\#1034](https://github.com/opencollective/opencollective/issues/1034) and [\#2333](https://github.com/opencollective/opencollective/issues/2333). - -If you have any suggestions on how to handle this better, feel free to join the discussions, start a new one, or send us an email [support@opencollective.com](mailto:support@opencollective.com). - ### I can't find my repository or my organization's repository. There are a few possible causes for that: @@ -66,7 +78,23 @@ Use the search bar to filter repositories by name: ## Manual verification -1. On the Collective creation page, choose **For open source projects**. -2. Check **I agree with the** [**terms of fiscal sponsorship**](https://docs.google.com/document/u/1/d/e/2PACX-1vQbiyK2Fe0jLdh4vb9BfHY4bJ1LCo4Qvy0jg9P29ZkiC8y_vKJ_1fNgIbV0p6UdvbcT8Ql1gVto8bf9/pub) and click on **Request manual verification**. -3. Proceed with the creation of your Collective! +If your project us not centred on a Github repository, or you can't get the automated verification system to work, you can request manual verification. + +1. Ensure your project meets the [acceptance criteria](). +2. Go to [https://opencollective.com/opensource/apply](https://opencollective.com/opensource/apply) +3. Check **I agree with the** [**terms of fiscal sponsorship**](https://docs.google.com/document/u/1/d/e/2PACX-1vQbiyK2Fe0jLdh4vb9BfHY4bJ1LCo4Qvy0jg9P29ZkiC8y_vKJ_1fNgIbV0p6UdvbcT8Ql1gVto8bf9/pub) +4. Click on **Request manual verification**. +5. Proceed to create your Collective and await manual review + +![Manual Verification Process](../.gitbook/assets/collectives_opensourcecollectives_manual_2021-06-18.png) + +When we review your Collective, we will look at the information you've provided, including links to your website and social media, and the info in your Collective's 'About' section. Please ensure these are up to date and correct on your Collective page. + +If we need more information about your project, we will get in touch with you via email to request it. + +### The permissions you ask for are overly generous and my organization doesn't want to grant them. + +We agree the permissions are overly generous. Unfortunately, there's not much we can do at the moment since this is the only scope we can use to read the info we need. We've discussed this at length on issues [\#355](https://github.com/opencollective/opencollective/issues/355), [\#1034](https://github.com/opencollective/opencollective/issues/1034) and [\#2333](https://github.com/opencollective/opencollective/issues/2333). + +If you have any suggestions on how to handle this better, feel free to join the discussions, start a new one, or send us an email [support@opencollective.com](Mailto:support@opencollective.com) diff --git a/collectives/projects.md b/collectives/projects.md index 9dc708c0..dd2ddf2e 100644 --- a/collectives/projects.md +++ b/collectives/projects.md @@ -8,6 +8,8 @@ Projects are a lightweight way for collectives to manage budgets for initiatives Projects have many of the same features as Collectives. Projects have their own balances, contributions and expenses. Projects can describe contribution tiers, set goals and provide updates. +Budgets are independent. Projects can only spend what is allocated to them. And what is available within the project is not available from the parent Collective. + ### Creating a Project Administrators can create a project from the collective profile page. Once you have registered an account and created a collective you can create a project by clicking 'create project' in the Projects area on your collective's profile page. You'll be asked to provide a project name, a URL and a description of your project: diff --git a/collectives/quick-start-guide.md b/collectives/quick-start-guide.md index d31f0320..4385e706 100644 --- a/collectives/quick-start-guide.md +++ b/collectives/quick-start-guide.md @@ -30,7 +30,7 @@ You can connect your Twitter account to your collective and automatically thank Write a blog post, tell people the vision, and explain why you are raising money. For more detailed ideas about helping your Collective launch well, check out [**Ten Steps to Successful Open Source Crowdfunding**](https://medium.com/open-collective/ten-steps-to-successful-open-source-crowdfunding-fa2b43e82687). -If you need help, join our community on [Slack](http://slack.opencollective.com/) or email support@opencollective.com. +If you need help, join our community on [Slack](http://slack.opencollective.com/) or contact us at [https://opencollective.com/support](https://opencollective.com/support). Welcome aboard!![](https://camo.githubusercontent.com/a346d93f5342c3381392034420a0deffe6cf2732/68747470733a2f2f6369332e676f6f676c6575736572636f6e74656e742e636f6d2f70726f78792f65665231325979577253523131506e4f4c447949567065327456336c76737365494c69586c5151596a38684f323263596f30523648744e436b4e69335578524a58617a7253523869444e34476474614e756e315362685f6773475f48476d354a4d4a316f55715862634c77526e6b626875514f7636706c35795f716c455643775145577a3076337179375458476237366f4c565668575a4d316b6f64794d505a5a776137314c543869687665325f695f6c6a306f6f71786d4351795a714f4f75762d575753345a3471423050444c4768643435375875746c6458704a653974436c357245564f734f4d734c4c497335667341786361675f4d4537584633762d6f7747444c724b76566f72303d73302d642d65312d667423687474703a2f2f656d61696c2e6f70656e636f6c6c6563746976652e636f6d2f6f2f654a78747938454e7779414d414d4270796f384b3138614742384f414d57716b7445524e31506d5441664b36315f5543514b6d7257386f6c67514245535a78393531666b5165674e303243513568754a706c62685157467539745735727162483872656e7a6f39374679506d46705155695551434d6b4a47474d615761346856334b5f4d62625f644a3772774a3555) diff --git a/collectives/tiers-goals.md b/collectives/tiers-goals.md index f97ea1af..e34292e1 100644 --- a/collectives/tiers-goals.md +++ b/collectives/tiers-goals.md @@ -50,7 +50,7 @@ Important information for Financial Contributors such as what does this tier mea #### **Interval** -The frequency in which such contribution will be charged. It can be a one time contribution, a monthly one, yearly or flexible. +The frequency in which such contribution will be charged. It can be a one time contribution, a monthly one, yearly or flexible. #### **Amount type** @@ -136,13 +136,13 @@ By subscribing to a support tier, you not only get private time for your team to #### Do I get an invoice? -Yes, you will receive an invoice emitted by the host of the collective \(Open Source Collective 501c6\). +Yes, you will receive an invoice emitted by the host of the collective \(for example, [Open Source Collective 501c6](https://opencollective.com/opensource)\). #### Can I do a Purchase Order \(PO\)? -Yes, you can pay with a credit card or we can work with you to go through your Purchase Order process. Just reach out to us: host+c6@opencollective.org. +Yes, you can pay with a credit card or we can work with you to go through your Purchase Order process. Just reach out to us: [host+c6@opencollective.org](mailto:host+c6@opencollective.org). #### What if we never were provided with support? -Please reach out to us and we will work it out \(support@opencollective.com\). +Please reach out to us and we will work it out \([support@opencollective.com](https://github.com/opencollective/documentation/tree/1b6b2a20534e35ca28433008c25dfde7a0e386fa/collectives/support@opencollective.com)\). diff --git a/contributing/design/contribution-guidelines.md b/contributing/design/contribution-guidelines.md index 89c79887..5e8b17cd 100644 --- a/contributing/design/contribution-guidelines.md +++ b/contributing/design/contribution-guidelines.md @@ -31,8 +31,10 @@ Empowering products enhance our abilities as humans without dictating our behavi * Give people the control they need to manage the algorithms that shape their experiences. * Give people the control they need to manage privacy and anonymity. * Enable focus by avoiding unnecessary notifications. -* _“Utility alone won’t assuage us. We want empowerment. We want to be better people. We want technology to enhance our capabilities and increase our sense of agency without dictating the rhythm of our lives.”_ -* _Jesse Weaver_ + + > _"Utility alone won’t assuage us. We want empowerment. We want to be better people. We want technology to enhance our capabilities and increase our sense of agency without dictating the rhythm of our lives.”_ + > + > _Jesse Weaver_ [https://medium.com/s/user-friendly/the-future-of-digital-product-design-is-about-human-empowerment-6a025bc330a](https://medium.com/s/user-friendly/the-future-of-digital-product-design-is-about-human-empowerment-6a025bc330a) @@ -87,8 +89,8 @@ Figma is the design tool of OC design, every interface design will be hosted ins The first thing you encounter with is this primary breakdown of the work: * [01 → Design System](https://www.figma.com/files/project/993339/01-%E2%86%92-Design-System) -* [02 → OpenCollective.com](https://www.figma.com/files/project/994190/02-%E2%86%92-OpenCollective.com) -* [01 → BackYourStack.com](https://www.figma.com/files/project/994191/03-%E2%86%92-BackYourStack.com) +* [02 → Web App](https://www.figma.com/files/project/994190/02-%E2%86%92-OpenCollective.com) +* [PRJ → BackYourStack.com](https://www.figma.com/files/project/994191/03-%E2%86%92-BackYourStack.com) ![](../../.gitbook/assets/4%20%283%29.png) @@ -122,11 +124,11 @@ We break down big goals to specific tasks using the following logic: There are different ways to get in the loop of design-related tasks in GitHub: -1. [**KanBan Board**](https://github.com/opencollective/opencollective/projects/2) +1. [**Project Boards**](https://github.com/opencollective/opencollective/projects) ![](../../.gitbook/assets/7%20%281%29%20%281%29.png) -1. [**Searching for design labels in the complete issue list.**](https://github.com/opencollective/opencollective/issues) +1. [**Searching for design labels in the complete issue list.**](https://github.com/opencollective/opencollective/issues?q=is%3Aopen+is%3Aissue+label%3Adesign) ![](../../.gitbook/assets/8%20%282%29.png)![](../../.gitbook/assets/9%20%281%29.png) diff --git a/contributing/development/best-practice-guidelines.md b/contributing/development/best-practice-guidelines.md index 553a7fee..b356c038 100644 --- a/contributing/development/best-practice-guidelines.md +++ b/contributing/development/best-practice-guidelines.md @@ -18,9 +18,9 @@ description: >- * I18n * The strings must be internationalized. See [/help/developers/translations](https://docs.opencollective.com/help/developers/translations). * Update the language files `npm run build:langs` and commit them to reflect the changes. -* Librairies +* Libraries * Whenever it's possible, we must use `styled-components` to write styles. See[ OC Styleguide.](https://styleguide.opencollective.com/) - * We're getting rid of `Bootstrap` and `material-ui`. Please don't use them for new developments. + * We're getting rid of `material-ui`. We still rely on this library for some stuff but please don't use it directly. * Icons must be imported from the [styled-icons](http://styled-icons.js.org/) library. * Testing * Tests written with Cypress must follow our [good practices](https://docs.opencollective.com/help/developers/testing-with-cypress) conventions. diff --git a/contributing/development/bounties.md b/contributing/development/bounties.md index 6d6d1fc9..d2469ec7 100644 --- a/contributing/development/bounties.md +++ b/contributing/development/bounties.md @@ -14,9 +14,9 @@ Our bounty program is about creating opportunities for our community to contribu #### No compromise on quality -We're not able to accept pull requests that aren't completed to a high standard in a reasonable timeframe. Please only pick up bounties that you are confident you can complete at your current knowledge and skill level. We will not accept pull requests or pay bounties for code that's not up to the standard we need to maintain for the Collectives who rely on this platform. +We're not able to accept pull requests that aren't completed to a high standard in a reasonable timeframe. Please only pick up bounties that you are confident you can complete at your current knowledge and skill level. We will not accept pull requests or pay bounties for code that's not up to the standard we need to maintain for the Collectives who rely on this platform. -Our dev team is happy to answer questions and provide some limited support, but we don't have capacity to mentor junior developers through the bounty program. +Our dev team is happy to answer questions and provide some limited support, but we don't have capacity to mentor junior developers through the bounty program. For general guidelines about what's expected in the code, [see more info here](https://docs.opencollective.com/help/about/contributing). @@ -47,7 +47,7 @@ We want to attract quality contributions. The issue will only be considered comp _See_ [_more info about getting paid_](https://docs.opencollective.com/help/expenses-and-getting-paid/submitting-expenses) _through Open Collective_ {% hint style="warning" %} -Issues tagged as "**bounty candidate**" are issues that we are considering to add bounties for, but that are not bounties yet - either because they lack proper specifications, a team consensus, or because we don't have the bandwidth to review it at the moment. Feel free to comment on such issues to ask for a bounty to be added if it's something you're willing to work on. +Issues tagged as "**bounty candidate**" are issues that we are considering to add bounties for, but that are not bounties yet - either because they lack proper specifications, a team consensus, or because we don't have the bandwidth to review it at the moment. Feel free to comment on such issues to ask for a bounty to be added if it's something you're willing to work on. **Financial compensation can only happen if the issue has a "bounty" tag with a pre-defined amount.** In other words, completing a bounty candidate that didn't receive the "bounty" tag will not make you eligible for the bounty program. {% endhint %} @@ -58,11 +58,11 @@ Issues tagged as "**bounty candidate**" are issues that we are considering to ad 2. Tag issues with the "bounty" label and amount \(e.g. "$100"\) 3. Add a comment with a basic explanation of the Bounty process and link to BOUNTY.md - > A $100 bounty was attached to this issue. Anyone submitting a Pull Request will be rewarded with $100 when the Pull Request is reviewed, accepted and merged. [More info](BOUNTY.md). + > A $100 bounty was attached to this issue. Anyone submitting a Pull Request will be rewarded with $100 when the Pull Request is reviewed, accepted and merged. [More info](https://docs.opencollective.com/help/contributing/development/bounties). 4. Make sure the issue is understandable for newcomers and expectations are clearly set -#### Contributor Ladder +#### Contributor Ladder 1. **First Time Contributors** * Not part of the Open Collective GitHub organization diff --git a/contributing/development/dev-contribution-guide.md b/contributing/development/dev-contribution-guide.md index 8178746b..d65765c9 100644 --- a/contributing/development/dev-contribution-guide.md +++ b/contributing/development/dev-contribution-guide.md @@ -28,7 +28,7 @@ You'll need to have some basic programming experience with the technologies and * [Introduction to Node.js - w/ quizzes](https://www.tutorialsteacher.com/nodejs/nodejs-tutorials) * [When, how and why to use Node.js](https://www.netguru.com/blog/use-node-js-backend) * [Differences between Javascript and Node.js](https://www.educba.com/javascript-vs-node-js/) -* **GraphQL** - Our API uses GraphQL, powered by [Sequelize](http://docs.sequelizejs.com/manual/getting-started.html) and [PostgreSQL](https://www.postgresql.org/). Understanding how these work is important to contributing to or fixing the majority of the issues on our API. To learn more, check out these tutorials & articles: +* **GraphQL** - Our API uses GraphQL, powered by [Sequelize](http://docs.sequelizejs.com/manual/getting-started.html) and [PostgreSQL](https://www.postgresql.org/). Understanding how this work is important to contributing to or fixing the majority of the issues on our API. To learn more, check out these tutorials & articles: * [What is GraphQL and how to use it](https://www.howtographql.com/) * [Basic concept of GraphQL](https://medium.com/@kalin.chernev/the-guide-to-learn-graphql-i-wish-i-found-few-months-go-97f9d9ca6f12) * [Getting GraphQL running](https://www.freecodecamp.org/news/a-beginners-guide-to-graphql-86f849ce1bec/) @@ -68,9 +68,9 @@ _NOTE: If you're only contributing frontend code, you don't need to setup the AP ### API -The API setup requires more effort than the frontend, as it requires installing the [PostgreSQL](https://www.postgresql.org/download/) and [PostGIS](https://postgis.net/install/) extensions. You might experience difficulty setting up the API on a Windows environment. We recommend using a Unix environment. \(We're currently working to make it easier on Windows\). +The API setup requires more effort than the frontend, as it requires installing the [PostgreSQL](https://www.postgresql.org/download/) and [PostGIS](https://postgis.net/install/) extensions. You might experience difficulty setting up the API on a Windows environment. We recommend using a Unix environment. -Just like the frontend, we have a separate document for the setup. +Just like the front end, we have a separate document for the setup. #### Setup guide diff --git a/contributing/development/testing-with-cypress.md b/contributing/development/testing-with-cypress.md index c5f801a8..e37f4ffb 100644 --- a/contributing/development/testing-with-cypress.md +++ b/contributing/development/testing-with-cypress.md @@ -75,7 +75,7 @@ Fills a stripe input. This function is used to open an email in Cypress. If the command succeed, a page with the email is loaded and you'll be able to run all the usual cypress commands \(`cy.get`, `cy.contains`...\) to test it. -* `fiterFunc` is a function used to filter the list of email. As soon as it returns `true`, command will start to open the email. For a complete list of the fields you can use to filter the email, see [https://github.com/djfarrelly/MailDev/blob/master/docs/rest.md](https://github.com/djfarrelly/MailDev/blob/master/docs/rest.md) +* `fiterFunc` is a function used to filter the list of emails. As soon as it returns `true`, command will start to open the email. For a complete list of the fields you can use to filter the emails, see [https://github.com/djfarrelly/MailDev/blob/master/docs/rest.md](https://github.com/djfarrelly/MailDev/blob/master/docs/rest.md) **Examples** diff --git a/contributing/documentation/resources-for-documentarians.md b/contributing/documentation/resources-for-documentarians.md index 015f760a..af71a8d4 100644 --- a/contributing/documentation/resources-for-documentarians.md +++ b/contributing/documentation/resources-for-documentarians.md @@ -18,7 +18,7 @@ As of November of 2019, a release notes tool is in the works. Until it is ready, Did you find a typo, a broken link or image? Do you think that something could be explained better? Feel free to [edit pages and submit a pull request](suggesting-changes.md)! -## Suggested tools +## Suggested tools {% tabs %} {% tab title="Linux" %} @@ -30,23 +30,21 @@ Firefox offers [a built-in tool](https://support.mozilla.org/en-US/kb/firefox-sc ### Flameshot -[Flameshot](https://flameshot.js.org) is open-source software that helps you take screenshots easily and edit them as soon as you take them. +[Flameshot](https://flameshot.org/) is open-source software that helps you take screenshots easily and edit them as soon as you take them. ### Shutter -If Flameshot doesn't work on your Linux installation, you may want to give [Shutter](https://launchpad.net/shutter) a shot. Shutter is also an open-source software focused on screen capture, but it isn't on active development. However, the editing tool for Shutter needs a few additional packages related to `GooCanvas`, a canvas widget for GTK+, to work. They should be installed in the following order: - -1. `libgoocanvas-common` \(translations\) - -2. `libgoocanvas3` \(shared library\) +If Flameshot doesn't work on your Linux installation, you may want to give [Shutter](https://launchpad.net/shutter) a shot. Shutter is also an open-source software focused on screen capture, but it isn't on active development. However, the editing tool for Shutter needs a few additional packages related to `GooCanvas`, a canvas widget for GTK+, to work. They should be installed in the following order: +1. `libgoocanvas-common` \(translations\) +2. `libgoocanvas3` \(shared library\) 3. `libgoo-canvas-perl` \(Perl interface\) Once you installed all of them, kill all running instances of Shutter \(using the `killall shutter` command\) and launch it again. The **Edit** option should become available as soon as you capture a new screenshot! ### Peek -[Peek](https://github.com/phw/peek) is open-source software that allows you to record portions of your screen and easily transform them into GIF, APNG, MP4, or WebM. +[Peek](https://github.com/phw/peek) is open-source software that allows you to record portions of your screen and easily transform them into GIF, APNG, MP4, or WebM. {% hint style="warning" %} You may stumble upon a few issues when using this software on Wayland. diff --git a/contributing/documentation/suggesting-changes.md b/contributing/documentation/suggesting-changes.md index 5d543d22..d986dbaf 100644 --- a/contributing/documentation/suggesting-changes.md +++ b/contributing/documentation/suggesting-changes.md @@ -31,7 +31,7 @@ If you'd like to know more about Git and GitHub, we recommend Git's [official do ## Understanding GitBook's integration with GitHub -We use a platform called [GitBook](https://www.gitbook.com/) to host, manage and serve our documentation. GitBook fetches files from our GitHub repository **opencollective/documentation**, reads them and converts them into the pages you can access on **docs.opencollective.org**. A generic structure of a documentation hosted on GitBook would look like this: +We use a platform called [GitBook](https://www.gitbook.com/) to host, manage and serve our documentation. GitBook fetches files from our GitHub repository **opencollective/documentation**, reads them and converts them into the pages you can access on [docs.opencollective.com](https://docs.opencollective.com). A generic structure of a documentation hosted on GitBook would look like this: {% tabs %} {% tab title="Generic structure of a GitBook" %} @@ -160,7 +160,7 @@ Contributing_Documentation_Suggesting_changes_New_pull_request_2019-04-29.png {% hint style="warning" %} Please create an issue on our documentation repository to discuss your ideas before taking any action. -1. Go to [**our Issue section**](https://github.com/opencollective/documentation/issues) and click on **New issue**. +1. Go to [**our Issue section**](https://github.com/opencollective/opencollective/issues) and click on **New issue**. 2. Describe what changes you are proposing and the motivation behind them: how will them improve our documentation? How should we proceed? 3. Click on **Submit new issue**. {% endhint %} @@ -245,5 +245,5 @@ But if you have access to the GitBook interface, here's what you should do to fi ![](../../.gitbook/assets/contributing_documentation_suggesting-changes_dead-links_2020-01-29.gif) -If you have any other questions about contributing to our documentation, please reach out to support@opencollective.com or join our `documentation` channel on [Slack](https://slack.opencollective.com). +If you have any other questions about contributing to our documentation, please reach out to [https://opencollective.com/support](https://opencollective.com/support) or join our `documentation` channel on [Slack](https://slack.opencollective.com). diff --git a/contributing/translation.md b/contributing/translation.md index 787bd2cb..8f2c7243 100644 --- a/contributing/translation.md +++ b/contributing/translation.md @@ -12,7 +12,7 @@ We use Crowdin to manage all our translations. You can join and contribute on: [ ## Adding a new language -To ask for a language to be added on Crowdin, feel free to open a discussion on [https://crowdin.com/project/opencollective/discussions](https://crowdin.com/project/opencollective/discussions). We always accept these requests, but please note that inactives languages will often been removed if there's no contribution. +To ask for a language to be added on Crowdin, feel free to open a discussion on [https://crowdin.com/project/opencollective/discussions](https://crowdin.com/project/opencollective/discussions). We always accept these requests, but please note that inactive languages will often been removed if there's no contribution. ## Format diff --git a/expenses-and-getting-paid/submitting-expenses.md b/expenses-and-getting-paid/submitting-expenses.md index 0ff118dc..d00ecce0 100644 --- a/expenses-and-getting-paid/submitting-expenses.md +++ b/expenses-and-getting-paid/submitting-expenses.md @@ -10,7 +10,7 @@ On the **Submit expense** page, you can submit two types of expenses, **reimburs ### Payee information -In the first step, you can specify who will be paid for this expense \(an individual or an organization\) and which payment method you wish to use. +In the first step, you can specify who will be paid for this expense \(an individual or an organization\) and which payment method you wish to use. If you are invoicing through a company, create an organization profile for your company and select it here instead of using your personal profile, so the correct entity is recorded as being paid for tax purposes. @@ -73,13 +73,13 @@ To open the submission form, click on **Invoice** and add a title to your expens ![](../.gitbook/assets/expenses-and-getting-paid_submitting-expenses_invoice-form_2020-05-12.gif) -If you have an invoice ready, you can upload it as an attachment to the expense. However, you are still required to set invoice details such as description, date and amount. +If you have an invoice ready, you can upload it as an attachment to the expense. However, you are still required to set invoice details such as description, date and amount. If you don't upload an invoice, the expense itself functions as an invoice for accounting purposes, as it contains all required information. ### Expense summary -The Expense summary provides you with an overview of the expense to be submitted, including attached files, items being paid for, payout preferences, etc. The summary allows you to review all info and quickly edit it if needed by clicking on **Edit expense**. +The Expense summary provides you with an overview of the expense to be submitted, including attached files, items being paid for, payout preferences, etc. The summary allows you to review all info and quickly edit it if needed by clicking on **Edit expense**. For invoices, the expense summary serves as the official invoice document. You can download it for your accounting records if you wish. @@ -109,19 +109,17 @@ It is also possible to invite a user that does not have an account on the platfo ![](../.gitbook/assets/expensesandgettingpaid_submittingexpenses_invitingnewuser_2021_4_8.gif) - - You are now able to _add additional information about the expense._ Pre-fill whatever info you already have, then invite the payee to fill in the rest and confirm. This can make the whole process a lot easier! ![](../.gitbook/assets/expensesandgettingpaid_submittingexpenses_addingadditionalinformation_2021_4_20.gif) -If you're inviting an organization to submit the expense, don't worry, they'll be offered the option to create the company profile when they submit the expense. +If you're inviting an organization to submit the expense, don't worry, they'll be offered the option to create the company profile when they submit the expense. When the user finishes editing the expense, the summary of the expense is displayed and they will be able to create their account and submit the expense in a single action: ![](../.gitbook/assets/image%20%2842%29.png) -After submitting the joining and submitting the edited expense, the expense now is saved in the platform and marked as _unverified_ until the users validate their email. After the user validates their email, the expense is marked as pending and is displayed for the collective's admins to approve, continuing its normal flow. +After joining and submitting the edited expense, the expense now is saved in the platform and marked as _unverified_ until the users validate their email. After the user validates their email, the expense is marked as pending and is displayed for the collective's admins to approve, continuing its normal flow. ![](../.gitbook/assets/image%20%2840%29.png) diff --git a/expenses-and-getting-paid/virtual-cards.md b/expenses-and-getting-paid/virtual-cards.md index b5e92a0a..1933b28b 100644 --- a/expenses-and-getting-paid/virtual-cards.md +++ b/expenses-and-getting-paid/virtual-cards.md @@ -1,30 +1,28 @@ # Virtual Cards -Virtual cards are an additional benefit offered to collectives through hosts. Hosts create virtual cards and assign them to a Collective. Anyone with access to that card can then use it to make payments on behalf of the Collective. This is particularly useful for covering recurring costs like hosting a website. +Virtual cards are an additional benefit offered to collectives through hosts. Hosts create virtual cards and assign them to a Collective. Anyone with access to that card can then use it to make payments on behalf of the Collective. This is particularly useful for covering recurring costs like hosting a website. -### Requesting a card +## Requesting a card Some Hosts accept requests for virtual cards. If you would like to request a Virtual Card select 'request card' from the 'action' menu on your collective's profile page. -### Using a virtual card +## Using a virtual card Virtual cards can be used to make purchases on behalf of your collective. Each card has an individual who is assigned the card for the purpose of filing expenses. Expenses are automatically created when the card is used and the assignee will be notified. -### Viewing card details +## Viewing card details To view virtual cards associated with a collective select 'virtual cards' from the Collective Settings menu: ![View Virtual Cards assigned to your Collective from the Collective's Seting menu. ](../.gitbook/assets/screenshot-2021-05-13-at-10.15.27.png) -To view the details of a card click 'view card details'. +To view the details of a card click 'view card details'. -### Automatically Paused Cards +## Automatically Paused Cards -Hosts can choose to pause virtual cards if there are any incomplete expenses. This is a protective measure to prevent abuse. If you host has paused a card you will not be able to use the card to make purchases util a receipt has been attached to the previous expense by the assignee. +Hosts can choose to pause virtual cards if there are any incomplete expenses. This is a protective measure to prevent abuse. If your host has paused a card you will not be able to use the card to make purchases until a receipt has been attached to the previous expense by the assignee. {% hint style="warning" %} -Be aware of your surroundings when viewing a card's details as others may be able to see them. +Be aware of your surroundings when viewing a card's details as others may be able to see them. {% endhint %} - - diff --git a/financial-contributors/collective-to-collective.md b/financial-contributors/collective-to-collective.md index eb0169de..b80026ab 100644 --- a/financial-contributors/collective-to-collective.md +++ b/financial-contributors/collective-to-collective.md @@ -1,12 +1,12 @@ # Collective to Collective -### Within the same Fiscal Host +## Within the same Fiscal Host If you have a Collective with funds in its balance, you may use that as a payment method when contributing to another Collective within the same [Fiscal Host](../fiscal-hosts/fiscal-hosts.md). There are no fees for this payment method. Simply make a contribution to the payee Collective and select the payer Collective as your payment method during checkout. -### Across different Fiscal Hosts +## Across different Fiscal Hosts -We are working on the functionality to enable Collectives to give directly to Collectives in a different host. As a workaround for now, use the following process: +We are working on the functionality to enable Collectives to give directly to Collectives in a different host \(see [\#3190](https://github.com/opencollective/opencollective/issues/3190)\). As a workaround for now, use the following process: 1. Contact the Fiscal Host of the payee Collective and ask them to submit an expense to the payer Collective for your donation 2. The payer Collective will approve the expense and its Fiscal Host will pay the Fiscal Host of the payee Collective. diff --git a/financial-contributors/financial-contributors.md b/financial-contributors/financial-contributors.md index 485335de..2a867daf 100644 --- a/financial-contributors/financial-contributors.md +++ b/financial-contributors/financial-contributors.md @@ -34,7 +34,7 @@ Yes. To do so, go to your Profile and click on the gear icon next to your avatar ## Can my Collective give to another Collective? -If both Collectives are in the same [Fiscal Host](../fiscal-hosts/fiscal-hosts.md), you can donate using the balance of a Collective. For example, most open source projects are hosted by the Open Source Collectives, so they can give to each other. +If both Collectives are in the same [Fiscal Host](../fiscal-hosts/fiscal-hosts.md), you can donate using the balance of a Collective. For example, most open source projects are hosted by the Open Source Collective, so they can give to each other. To make a Collective-to-Collective donation, go to the page of the Collective and select your contribution amount. You will be given the option to donate from any Collective you are a core contributor of. diff --git a/financial-contributors/organizations/funds.md b/financial-contributors/organizations/funds.md index e772abb6..4a32da82 100644 --- a/financial-contributors/organizations/funds.md +++ b/financial-contributors/organizations/funds.md @@ -4,7 +4,7 @@ description: a new way of supporting your community # Funds -We wanted to make it easier for organisations to support multiple projects. +We wanted to make it easier for organisations to support multiple projects. As opposed to a creating a [collective](../../about/terminology.md#collectives), **Funds** is primarily designed for disbursing money, e.g., through grant-making. If you are more focused on disbursing funds than receiving them, a **Fund** may be a good fit for you. @@ -20,52 +20,48 @@ A **Fund** includes: * Transparent financial management on the Open Collective Platform * More flexibility with what you choose to publicly show \(in terms of expense management\) * Protect identities of those receiving grants - * e.g. emergency relief aid may not want to be as public * Will still be reported and available to fiscal host - - -### What is a Fund? +## What is a Fund? A Fund is a profile designed for one or a few large sponsor companies to move chunks of money under our umbrella and then frictionlessly distribute it to as many collectives as they want. Some Funds are in the name of a particular company, while others are focused on a topic. -### Why do we need Funds? +## Why do we need Funds? -Big companies call the process for paying for stuff “procurement”. It’s often pretty involved, with contracts, invoices, purchasing order numbers, and bureaucracy—a painful thing to go through repeatedly for small amounts. +Big companies call the process for paying for stuff “procurement”. It’s often pretty involved, with contracts, invoices, purchasing order numbers, and bureaucracy—a painful thing to go through repeatedly for small amounts. It is so much simpler and more practical to ask corporations to make one large payment, to one vendor. As an umbrella non-profit, we are set up for exactly this, and Funds are a feature on the platform to make the experience even better, and more scalable. -### **Who can create a Fund?** +## **Who can create a Fund?** -Funds can be created by an organisation. +Funds can be created by an organisation. -**Funds** allows for more customization in the transparency of an initiative. This is a great way to issue grants to recipients of emergency aid, human rights activists and censorship targets, for example, for whom more privacy is essential. +**Funds** allows for more customization in the transparency of an initiative. This is a great way to issue grants to recipients of emergency aid, human rights activists and censorship targets, for example, for whom more privacy is essential. -It's also perfect for initiatives who want it to be easier to distribute money _outside_ of Open Source Collective. **Funds** is the best way to manage your FOSS support fund to projects in or out of your OSC fund since you'll **only need to deal with one vendor** \(us!\). +It's also perfect for initiatives who want it to be easier to distribute money _outside_ of Open Source Collective. **Funds** is the best way to manage your FOSS support fund to projects in or out of your OSC fund since you'll **only need to deal with one vendor** \(us!\). With **Funds**, we can now offer more flexibility for managing finances and expenses. {% hint style="info" %} -A **Fund** is likely less interested in the 'social' & crowdfunding aspects of fundraising. This type of account will have a more simplified version of our dashboard for those who don't want all the extra features that group-organizing benefits from. +A **Fund** is likely less interested in the 'social' & crowdfunding aspects of fundraising. This type of account will have a more simplified version of our dashboard for those who don't want all the extra features that group-organizing benefits from. {% endhint %} -### **Who can Funds pay?** +## **Who can Funds pay?** Lots of projects sign up with us because they don’t have their own company or foundation to work through. But you don’t have to be on Open Collective. Any collective—whether they are part of a company, have their own foundation, work with another fiscal host, or are unincorporated—can get contributions from a Fund. -The Funds admins approve what money gets spent on, but when it comes to invoices, purchase orders, payment processing, tax forms, etc, they don't need to worry about it. We take care of all that, and interface with the payees. This makes it a lot easier for both of them. +The Funds admins approve what money gets spent on, but when it comes to invoices, purchase orders, payment processing, tax forms, etc, they don't need to worry about it. We take care of all that, and interface with the payees. This makes it a lot easier for both of them. The key to creating scalable, resilient projects is to support the community as a whole in ways that serve the full range of projects and creators. Open Collective liberates corporate support, getting it directly to projects at scale, across languages and ecosystems. -### How is funding decided? +## How is funding decided? It's up to the creators of the Fund what the process is. Open Collective has a 'request a grant' function that some use to receive proposals from projects. Others use their Fund to process payments for an external program with its own process. Others have an internal team who decides where the money goes and they don't take requests. We carry out their decisions about what the money is spent on and handle the logistics, but the Fund administrators are in the driver's seat. -### **How do you create a fund?** +## **How do you create a fund?** - -****[Reach out to us](mailto:support@opencollective.com) for more information if you are wanting to set up a Fund with OC! +_\*\*_[Reach out to us](https://opencollective.com/support) for more information if you are wanting to set up a Fund with OC! For more information about our mission regarding funding and the initial organisations that came on board, [please read Pia's release blog. ](https://blog.opencollective.com/funds-for-open-source/) diff --git a/financial-contributors/organizations/organization-faq.md b/financial-contributors/organizations/organization-faq.md index 20728d61..602222ca 100644 --- a/financial-contributors/organizations/organization-faq.md +++ b/financial-contributors/organizations/organization-faq.md @@ -44,7 +44,7 @@ We offer tools to help you find Collectives that are providing value for your co ## Can we pay via bank transfer or other means? -Yes. If paying via credit card through our automated system doesn't work for your process, please reach out to support@opencollective.com and we can arrange to accept payment. +Yes. If paying via credit card through our automated system doesn't work for your process, please reach out to [https://opencollective.com/support](https://opencollective.com/support) and we can arrange to accept payment. ## Can we make a bulk payment? @@ -52,7 +52,7 @@ Yes. You can send us funds with a single transaction, and we'll allocate it to y ## Can we get an invoice in advance? -Yes. Contributions through our platform will automatically generate receipts after payment, but [Fiscal hosts](../../fiscal-hosts/fiscal-hosts.md) \(like the Open Source Collective\) can function like any vendor or supplier and provide the documentation you require. If you need an invoice in advance, or for us to register in your vendor system, let us know at support@opencollective.com. +Yes. Contributions through our platform will automatically generate receipts after payment, but [Fiscal hosts](../../fiscal-hosts/fiscal-hosts.md) \(like the Open Source Collective\) can function like any vendor or supplier and provide the documentation you require. If you need an invoice in advance, or for us to register in your vendor system, let us know at [https://opencollective.com/support](https://opencollective.com/support). ## Who are we transacting with legally? diff --git a/financial-contributors/organizations/sustainer-resources.md b/financial-contributors/organizations/sustainer-resources.md index 7f35f7cb..d3cd6f4d 100644 --- a/financial-contributors/organizations/sustainer-resources.md +++ b/financial-contributors/organizations/sustainer-resources.md @@ -24,10 +24,10 @@ _Please keep adding them <3_ Thanks [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw) for providing this great service! [@fbOpenSource](https://twitter.com/fbOpenSource?ref_src=twsrc%5Etfw) Thanks for all your contributions to OSS 🙌 [https://t.co/NxnvC8Xi4f](https://t.co/NxnvC8Xi4f)— JS.coach \(@\_jscoach\) [November 14, 2017](https://twitter.com/_jscoach/status/930429575867355136?ref_src=twsrc%5Etfw) -💸Small yet significant step in the [\#mobx](https://twitter.com/hashtag/mobx?src=hash&ref_src=twsrc%5Etfw) community. Today I could paid contributor for a significant contribution to MST from our [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw)! - -👏 Tnx to [@coinbase](https://twitter.com/coinbase?ref_src=twsrc%5Etfw) [@algolia](https://twitter.com/algolia?ref_src=twsrc%5Etfw) [@fbOpenSource](https://twitter.com/fbOpenSource?ref_src=twsrc%5Etfw) & all other sponsors! - +💸Small yet significant step in the [\#mobx](https://twitter.com/hashtag/mobx?src=hash&ref_src=twsrc%5Etfw) community. Today I could paid contributor for a significant contribution to MST from our [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw)! + +👏 Tnx to [@coinbase](https://twitter.com/coinbase?ref_src=twsrc%5Etfw) [@algolia](https://twitter.com/algolia?ref_src=twsrc%5Etfw) [@fbOpenSource](https://twitter.com/fbOpenSource?ref_src=twsrc%5Etfw) & all other sponsors! + 🎉It works even when you're not [@webpack](https://twitter.com/webpack?ref_src=twsrc%5Etfw) [https://t.co/NJTnMcA8NI](https://t.co/NJTnMcA8NI)— Michel Weststrate \(@mweststrate\) [July 16, 2018](https://twitter.com/mweststrate/status/1018928640388730880?ref_src=twsrc%5Etfw) The tooling for open source projects is so good these days! @@ -40,26 +40,26 @@ The tooling for open source projects is so good these days! [@zeithq](https://twitter.com/zeithq?ref_src=twsrc%5Etfw) - deployment & domains -[@travisci](https://twitter.com/travisci?ref_src=twsrc%5Etfw) & [@appveyor](https://twitter.com/appveyor?ref_src=twsrc%5Etfw) - CI - +[@travisci](https://twitter.com/travisci?ref_src=twsrc%5Etfw) & [@appveyor](https://twitter.com/appveyor?ref_src=twsrc%5Etfw) - CI + Seriously amazing! 🙏— Devon Govett \(@devongovett\) [July 9, 2018](https://twitter.com/devongovett/status/1016415051190714368?ref_src=twsrc%5Etfw) -Flights and hotel booked! That means I'm ready for [@vue\_london](https://twitter.com/vue_london?ref_src=twsrc%5Etfw) ✅ - -Really looking forward to meet all these nice people and especially I'm very happy to meet [@Atinux](https://twitter.com/Atinux?ref_src=twsrc%5Etfw) and @\_achopin for the first time. - +Flights and hotel booked! That means I'm ready for [@vue\_london](https://twitter.com/vue_london?ref_src=twsrc%5Etfw) ✅ + +Really looking forward to meet all these nice people and especially I'm very happy to meet [@Atinux](https://twitter.com/Atinux?ref_src=twsrc%5Etfw) and @\_achopin for the first time. + Thanks a million to [@nuxt\_js](https://twitter.com/nuxt_js?ref_src=twsrc%5Etfw), who sponsored the ticket through [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw) 🙏— Alexander Lichter \(@TheAlexLichter\) [September 10, 2018](https://twitter.com/TheAlexLichter/status/1039213736962220032?ref_src=twsrc%5Etfw) This is why we use [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw) :-\). FT Maintainers \(non-single-co backed\) + Contributor Pool. [https://t.co/NxGfe8V8cW](https://t.co/NxGfe8V8cW)— SEAN LARKIN 廖肖恩 \(@TheLarkInn\) [September 20, 2018](https://twitter.com/TheLarkInn/status/1042906557149675520?ref_src=twsrc%5Etfw) Depends on your budget. We're around $10k/y, and we pay out ~5-10% of avail. budget for each large contribution, and small token payments for fixed issues. Federated/open ownership of the books is why we are happy with [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw).— Goose \(@RickCasey\) [December 20, 2017](https://twitter.com/RickCasey/status/943381328329920512?ref_src=twsrc%5Etfw) -OP: [https://t.co/2qdL9slcrr](https://t.co/2qdL9slcrr) - +OP: [https://t.co/2qdL9slcrr](https://t.co/2qdL9slcrr) + Sponsoring a project is deeper then money, but partnerships working together for common good. [\#FOSS](https://twitter.com/hashtag/FOSS?src=hash&ref_src=twsrc%5Etfw) [\#JavaScript](https://twitter.com/hashtag/JavaScript?src=hash&ref_src=twsrc%5Etfw)— SEAN LARKIN 廖肖恩 \(@TheLarkInn\) [October 13, 2017](https://twitter.com/TheLarkInn/status/918924376157777920?ref_src=twsrc%5Etfw) -We strongly believe that someday we could fully focus on [\#opensource](https://twitter.com/hashtag/opensource?src=hash&ref_src=twsrc%5Etfw) to make [@nodejs](https://twitter.com/nodejs?ref_src=twsrc%5Etfw) world better 🚀🔥 [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw) - +We strongly believe that someday we could fully focus on [\#opensource](https://twitter.com/hashtag/opensource?src=hash&ref_src=twsrc%5Etfw) to make [@nodejs](https://twitter.com/nodejs?ref_src=twsrc%5Etfw) world better 🚀🔥 [@opencollect](https://twitter.com/opencollect?ref_src=twsrc%5Etfw) + 👍 enjoy using [@nestframework](https://twitter.com/nestframework?ref_src=twsrc%5Etfw)? 🙌 ask your company to support us: 🎁 [https://t.co/taYS49lllr](https://t.co/taYS49lllr) [pic.twitter.com/L1O9Vf5uhS](https://t.co/L1O9Vf5uhS)— NestJS \(@nestframework\) [April 25, 2018](https://twitter.com/nestframework/status/989207884700553221?ref_src=twsrc%5Etfw) @@ -98,7 +98,7 @@ Read Trivago's quotes [here](https://medium.com/webpack/trivago-sponsors-webpack [Webpack](https://medium.com/webpack/trivago-sponsors-webpack-for-second-year-bfe6ca2f0702) -[Open EMR](https://www.openemr.blog/post/accepting-donations-on-opencollective/) +[Open EMR](https://www.open-emr.org/blog/accepting-donations-on-opencollective/) [FeathersJS](https://blog.feathersjs.com/flying-into-2018-13bda623f089) diff --git a/financial-contributors/payments.md b/financial-contributors/payments.md index 8169a87d..ba1be1a7 100644 --- a/financial-contributors/payments.md +++ b/financial-contributors/payments.md @@ -56,9 +56,9 @@ You'll then get an email to register on Open Collective. Click on the given link ![](../.gitbook/assets/image%20%2821%29.png) -#### 2. By signin in +#### 2. By signing in -Signin in directly by clicking on the "Sign in" button in the top navbar will have the same effect of verifying your account directly. +Sign in directly by clicking on the "Sign in" button in the top navbar will have the same effect of verifying your account directly. ## Payment changes diff --git a/financial-contributors/receipts.md b/financial-contributors/receipts.md new file mode 100644 index 00000000..54612e35 --- /dev/null +++ b/financial-contributors/receipts.md @@ -0,0 +1,24 @@ +# Receipts + +You should have received a receipt by email from Open Collective at the time of your donation. However, if that is not available to you, here are instructions on how you can generate a receipt for tax purposes. + +**Instructions for Accessing Receipts via Settings** + +1. Ensure you are [signed in](https://opencollective.com/signin?next=%2F) with the email address you used to process the transaction. +2. Click on your name in the top right hand corner. +3. Under **My Account** click on Settings. + +![](../.gitbook/assets/financial_contributions_receipts_settings_2021-06-17.png) + +4. Click on Payment Receipts, you should then be able to see all of your contributions + +**Instructions for Downloading a Tax Receipt from the Collectives page** + +1. Ensure you are [signed in](https://opencollective.com/signin?next=%2F) with the email address you used to process the transaction. +2. Go to the collectives page you supported +3. Scroll down to 'Budget and click 'Transactions' +4. Click on 'View All Transactions'. +5. On the right, in the 'Search' window next to 'Transacations' type in your name. +6. Find your contribution\(s\) and click on 'View Details'. +7. Click 'Download Receipt' and you will download a PDF of your receipt that can be use for tax purposes. + diff --git a/fiscal-hosts/add-funds-manually.md b/fiscal-hosts/add-funds-manually.md index 393e2f19..04b78f6b 100644 --- a/fiscal-hosts/add-funds-manually.md +++ b/fiscal-hosts/add-funds-manually.md @@ -19,7 +19,7 @@ And fill the form with all required information to add the funds to that Collect ![The form to manually add funds to a Collective.](../.gitbook/assets/fiscal-hosts-add-funds-manually-addition-form-2020-09-18.png) * The **amount** of funds you want to send to a Collective. -* Your **host fee**, which is the fee you charge your Collectives. It's already set to your default, but you change it to a one-time fee of your preference. +* Your **host fee**, which is the fee you charge your Collectives. It's already set to your default, but you can change it to a one-time fee of your preference. * A short **description** of those funds. * The **source** of those funds. It can be your Fiscal Host, another Collective, or an Organization. diff --git a/fiscal-hosts/fiscal-host-dashboard.md b/fiscal-hosts/fiscal-host-dashboard.md index c0dc6ec3..bafaa7e7 100644 --- a/fiscal-hosts/fiscal-host-dashboard.md +++ b/fiscal-hosts/fiscal-host-dashboard.md @@ -32,7 +32,7 @@ Green button for manual payments. After paying via another method \(bank transfe Host admins have permission to edit expenses at any time. For example, someone wasn't able to attach their receipt and emailed it instead, and you are adding it for them. -**Note:** If you edit an expense, it much be re-approved. +**Note:** If you edit an expense, it must be re-approved. #### Open Expense @@ -89,5 +89,3 @@ Shows all incoming contributions. ![](../.gitbook/assets/image%20%287%29.png) -### - diff --git a/fiscal-hosts/fiscal-host-settings/connected-accounts.md b/fiscal-hosts/fiscal-host-settings/connected-accounts.md index 6cf68e81..ddb11240 100644 --- a/fiscal-hosts/fiscal-host-settings/connected-accounts.md +++ b/fiscal-hosts/fiscal-host-settings/connected-accounts.md @@ -24,13 +24,13 @@ This feature is currently in **Beta** test, read more about it below. We're currently testing this feature with the help of selected Host collectives. -If you're interested in testing this feature, please reach out through support@opencollective.com. If you're already testing the feature and wish to leave the test, you can also send an email to support. +If you're interested in testing this feature, please reach out through [https://opencollective.com/support](https://opencollective.com/support). If you're already testing the feature and wish to leave the test, you can also send an email to support. ### Fees #### What are the fees involved? -There are the payment processor fees charged by PayPal and if you're subjected to, the platform fees charged by Open Collective. +There are payment processor fees charged by PayPal and if you're subjected to, the platform fees charged by Open Collective. The payment processor fees will be automatically deducted from the original charge but as of now, the platform fees can not be automatically deducted. For the current beta, this debt will be settled once a month through an invoice we'll send you. @@ -50,7 +50,7 @@ If you're already in the beta test group, you can follow these instructions: ![](../../.gitbook/assets/screen-record-from-2020-07-10-13.30.21.gif) -* [ ] Now, let's copy the necessary information to Open Collective. +* [ ] Now, copy the necessary information to Open Collective. * Open a new tab and go to [Open Collective](https://www.opencollective.com). * Open your Host collective settings page and click in the _Receiving Money_ option in the menu. * Copy and paste _Client ID, Secret_ in the respective fields, leave Webhook ID empty. diff --git a/fiscal-hosts/local-tax.md b/fiscal-hosts/local-tax.md index d28e82b4..1d021075 100644 --- a/fiscal-hosts/local-tax.md +++ b/fiscal-hosts/local-tax.md @@ -6,7 +6,7 @@ description: This page describes how to set up charging local taxes In certain countries or regions, Fiscal Hosts are required to collect local taxes—for example, VAT in the EU. -Please contact support@opencollective.com if you need Collectives under your umbrella to charge taxes. We will work with you to conform to your local legislation. +Please contact [https://opencollective.com/support](https://opencollective.com/support) if you need Collectives under your umbrella to charge taxes. We will work with you to conform to your local legislation. ## VAT @@ -34,9 +34,7 @@ If the collective has a VAT number and should be responsible for collecting VAT ![](../.gitbook/assets/image%20%2816%29%20%281%29.png) - - ## GST \(New Zealand\) -GST is also supported for New Zealand. [Contact us](mailto:support@opencollective.com)! +GST is also supported for New Zealand. [Contact us](https://opencollective.com/support)! diff --git a/fiscal-hosts/open-source-collective.md b/fiscal-hosts/open-source-collective.md deleted file mode 100644 index 7337e3cb..00000000 Binary files a/fiscal-hosts/open-source-collective.md and /dev/null differ diff --git a/fiscal-hosts/payouts/README.md b/fiscal-hosts/payouts/README.md index 764e8a19..50c6d8db 100644 --- a/fiscal-hosts/payouts/README.md +++ b/fiscal-hosts/payouts/README.md @@ -31,7 +31,7 @@ For single payments larger than $2,000, make a manual payment. ### How do I pay out Expenses with TransferWise? -TransferWise is still in beta release so the first thing is to request access to the feature through support@opencollective.com. +TransferWise is still in beta release, so the first thing is to request access to the feature through [https://opencollective.com/support](https://opencollective.com/support). After getting access to the feature, you'll be able to connect to your TransferWise account through the Connected Accounts menu in your settings. You can follow [these instructions](payouts-with-transferwise.md) to do so. diff --git a/fiscal-hosts/payouts/payouts-with-paypal.md b/fiscal-hosts/payouts/payouts-with-paypal.md index 167d746b..d10873fc 100644 --- a/fiscal-hosts/payouts/payouts-with-paypal.md +++ b/fiscal-hosts/payouts/payouts-with-paypal.md @@ -23,7 +23,7 @@ For single payments larger than $2,000, make a manual payment. We're currently testing this feature with the help of selected Host collectives. -If you're interested in testing this feature, please reach out through support@opencollective.com. If you're already testing the feature and wish to leave the test, you can also send an email to support. +If you're interested in testing this feature, please reach out through [https://opencollective.com/support](https://opencollective.com/support). If you're already testing the feature and wish to leave the test, you can also send an email to support. {% endhint %} For hosts that are using PayPal, this integration can be used to automate expense payment by providing a one-click solution for paying expenses using [PayPal Payouts](https://developer.paypal.com/docs/payouts/). @@ -65,12 +65,12 @@ These fees are paid by the collective the expense was submitted for. This means ### Connecting to PayPal Payouts {% hint style="info" %} -PayPal Payouts is currently in beta test, if you're interested in testing this feature, please reach out through **support@opencollective.com**. +PayPal Payouts is currently in beta test, if you're interested in testing this feature, please reach out through [https://opencollective.com/support](https://opencollective.com/support). {% endhint %} If you're already in the beta test group, you can follow these instructions: -1. [ ] Create a new PayPal app +1. Create a new PayPal app * Open [PayPal's Developer](https://developer.paypal.com/developer/applications/) page and Log In. * In _My Apps & Credentials_ page, select the **Live** environment, and click in _Create app_. @@ -82,11 +82,11 @@ If you're already in the beta test group, you can follow these instructions: ![](../../.gitbook/assets/screen-record-from-2020-07-10-13.30.21.gif) -* [ ] Now, let's copy the necessary information to Open Collective. - * Open a new tab and go to [Open Collective](https://www.opencollective.com). - * Open your Host collective settings page and click on the _Sending Money_ option in the menu. - * Copy and paste _Client ID_ and _Secret_ in the respective fields. - * Click _Connect PayPal_ +1. Now, copy the necessary information to Open Collective. + * Open a new tab and go to [Open Collective](https://www.opencollective.com). + * Open your Host collective settings page and click on the _Sending Money_ option in the menu. + * Copy and paste _Client ID_ and _Secret_ in the respective fields. + * Click _Connect PayPal_ ![](../../.gitbook/assets/peek-2021-04-15-16-00.gif) @@ -98,6 +98,6 @@ Done! Next time you pay for an expense submitted with PayPal and you select the In order to reduce risks related to having an active API token that is able to create and fund transactions, we strongly suggest you: -1. Keep just enough balance in PayPal to pay your expenses. - * This can be achieved by calculating the amount needed for the current payment cycle and transferring it beforehand. +* Keep just enough balance in PayPal to pay your expenses. + * This can be achieved by calculating the amount needed for the current payment cycle and transferring it beforehand. diff --git a/fiscal-hosts/payouts/payouts-with-transferwise.md b/fiscal-hosts/payouts/payouts-with-transferwise.md index 71f8549c..a8a12531 100644 --- a/fiscal-hosts/payouts/payouts-with-transferwise.md +++ b/fiscal-hosts/payouts/payouts-with-transferwise.md @@ -12,7 +12,7 @@ After connecting your Wise account, users submitting new expenses will have acce ### What are the fees involved? -The fees are charged by Wise and its value will vary with the currencies being and value being transferred. You can read more about [Wise fees here](https://transferwise.com/help/13/understanding-fees-and-rates/2522717/how-do-you-determine-your-fees). +The fees are charged by Wise and its value will vary with the currencies and value being transferred. You can read more about [Wise fees here](https://transferwise.com/help/13/understanding-fees-and-rates/2522717/how-do-you-determine-your-fees). ### Who pays these fees? @@ -43,7 +43,7 @@ These fees are paid by the collective the expense was submitted for. This means ![](../../.gitbook/assets/screenshot-from-2021-05-12-18-49-51.png) * Done! Now all your hosted collectives will be able to submit Bank Transfer expenses compatible with TransferWise and you'll be able to pay for it with one click. - * Notice that this option will only be available for new expenses, expenses created before these steps are not structured as required by Wise and will need to be edited or recreated by the payee. + * Notice that this option will only be available for new expenses. Expenses created before Wise support was added are not structured as required by Wise and will need to be edited or recreated by the payee. ## Reducing Risks diff --git a/fiscal-hosts/refunds.md b/fiscal-hosts/refunds.md index ce045413..8f3777e9 100644 --- a/fiscal-hosts/refunds.md +++ b/fiscal-hosts/refunds.md @@ -1,10 +1,10 @@ # Refunds {% hint style="warning" %} -Refunds are processed by Fiscal Host administrators. If you are not the admin, contact your fiscal host \(or Open Collective support if your host is managed by Open Collective\). +Refunds are processed by Fiscal Host administrators. If you are not the admin, contact your fiscal host \(or [Open Collective support](https://opencollective.com/support) if your host is managed by Open Collective\). {% endhint %} -### **To refund a donation as a Fiscal Host admin:** +## **To refund a donation as a Fiscal Host admin:** Go to the Collective page and head to the **Budget** section. diff --git a/fiscal-hosts/virtual-cards.md b/fiscal-hosts/virtual-cards.md index 3890af86..f0d437f1 100644 --- a/fiscal-hosts/virtual-cards.md +++ b/fiscal-hosts/virtual-cards.md @@ -1,60 +1,58 @@ # Virtual Card Settings -Virtual cards can be offered to collectives through Hosts. Hosts create virtual cards using our provider [Privacy.com](https://privacy.com/) and assign them to a Collective. Anyone with access to that card can then use it to make payments on behalf of the Collective. When a payment is made an expense is automatically created for the Collective and the owner is notified to attach a receipt. Virtual Cards are particularly useful for recurring payments like hosting a website. +Virtual cards can be offered to collectives through Hosts. Hosts create virtual cards using our provider [Privacy.com](https://privacy.com/) and assign them to a Collective. Anyone with access to that card can then use it to make payments on behalf of the Collective. When a payment is made an expense is automatically created for the Collective and the owner is notified to attach a receipt. Virtual Cards are particularly useful for recurring payments like hosting a website. -### Accessing Virtual Card Settings +## Accessing Virtual Card Settings To access your virtual card settings and policy select 'Virtual Cards' from your host profile settings page: ![Virtual Card policy and settings ](../.gitbook/assets/screenshot-2021-05-13-at-17.06.26%20%281%29.png) -### Setting a policy +## Setting a policy Hosts have complete control over when, how and to who they provide Virtual Cards. Hosts can define their own policy in the 'Virtual Card Policy Information' area. -### Automatically pausing and resuming virtual cards +## Automatically pausing and resuming virtual cards -Toggle the 'automatically pause and resume cards' option to automatically pause virtual cards if there are any incomplete expenses. If a card has been paused Collectives will not be able to use the card to make purchases until a receipt has been attached to the previous expense by the assignee. This is a protective measure to prevent abuse. +Toggle the 'automatically pause and resume cards' option to automatically pause virtual cards if there are any incomplete expenses. If a card has been paused Collectives will not be able to use the card to make purchases until a receipt has been attached to the previous expense by the assignee. This is a protective measure to prevent abuse. -### Enabling users to request virtual cards +## Enabling users to request virtual cards -It is possible to create and assign virtual cards to Collectives without enabling users to request them. Toggle the 'allow collectives to request a card' option to allow Collectives to request a card. Collectives can request a Virtual Card by clicking 'Request a card' from their +It is possible to create and assign virtual cards to Collectives without enabling users to request them. Toggle the 'allow collectives to request a card' option to allow Collectives to request a card. Collectives can request a Virtual Card by clicking 'Request a card' from their -### Creating and assigning cards +## Creating and assigning cards -Virtual Cards are created using our provider [Privacy.com](https://privacy.com/). To create a card on [Privacy.com](https://privacy.com/) register and follow the details [here](https://privacy.com/virtual-card). +Virtual Cards are created using our provider [Privacy.com](https://privacy.com/). To create a card on [Privacy.com](https://privacy.com/) register and follow the details [here](https://privacy.com/virtual-card). Once you have created a card on [Privacy.com](https://privacy.com/) you can assign it to a Collective: ![Assigning a Virtual Card](../.gitbook/assets/screenshot-2021-05-12-at-12.54.06.png) -Select a Collective then select a user who is responsible for this card. This user will be automatically added to expenses created when a purchase is made using this card and they will be notified and asked to provide an receipt. +Select a Collective then select a user who is responsible for this card. This user will be automatically added to expenses created when a purchase is made using this card and they will be notified and asked to provide an receipt. -Click 'save card' to save the card to the Collective. +Click 'Save Card' to save the card to the Collective. -### Viewing Card details +## Viewing Card details -You can view all cards assigned to Collectives from the Virtual Cards settings page. Here you can filter cards by status, merchant and Collective. +You can view all cards assigned to Collectives from the Virtual Cards settings page. Here you can filter cards by status, merchant and Collective. ![Filter virtual cards by status, merchant or collective.](../.gitbook/assets/screenshot-2021-05-12-at-16.11.02.png) Each card shows the name, status, assigned collective, when the card was assigned and any limits set on the card in Privacy.com. The last four digits of the card are also shown. To view the full details of a card click 'view card details'. {% hint style="warning" %} -Be aware of your surroundings when viewing a card's details as others may be able to see them. +Be aware of your surroundings when viewing a card's details as others may be able to see them. {% endhint %} -### Changing virtual card spending limits, owners and collectives +## Changing virtual card spending limits, owners and collectives -Virtual Card spending limits can be modified using Privacy.com. We do not provide facilities for moving cards between Users or Collectives. This ensures that we have clear records for Collectives with clear responsibilities. If you need to re-assign a card, delete the card then create and assign a new one instead. +Virtual Card spending limits can be modified using Privacy.com. We do not provide facilities for moving cards between Users or Collectives. This ensures that we have clear records for Collectives with clear responsibilities. If you need to re-assign a card, delete the card then create and assign a new one instead. -If you need to make a change to initiative's card, please update to the correct amount in Privacy.com, and then email [support@opencollective.com](mailto:support@opencollective.com) with a screenshot so that our team can make the adjustment on the platform. +If you need to make a change to initiative's card, please update to the correct amount in Privacy.com, and then contact us at [https://opencollective.com/support](https://opencollective.com/support) with a screenshot so that our team can make the adjustment on the platform. -### Pausing, resuming and deleting a card +## Pausing, resuming and deleting a card -To pause a card select 'pause card' from the actions menu from the virtual cards page. Paused cards cannot be used to make payments, any recurring payments will also be paused. To resume a card select 'Unpause card' from the actions menu. To remove a card from the collective select 'Delete card' from the Actions menu. +To pause a card select 'pause card' from the actions menu from the virtual cards page. Paused cards cannot be used to make payments, any recurring payments will also be paused. To resume a card select 'Unpause card' from the actions menu. To remove a card from the collective select 'Delete card' from the Actions menu. ![Pause, resume and delete cards from the Action menu.](../.gitbook/assets/screenshot-2021-05-12-at-15.29.39.png) - - diff --git a/internal/issue-labels.md b/internal/issue-labels.md index e2677e14..b81ff2ab 100644 --- a/internal/issue-labels.md +++ b/internal/issue-labels.md @@ -8,11 +8,11 @@ Bug Feature Enhancement ### Emergency -These are issues that block critical flows for example Ledger issues such us \(double charging, no charging, wrong charging, wrong assigning of subscriptions\) Log in issues \(user can't log in, user can't make a contribution\) Expectation of resolving: immediately - On-call schedule applies +These are issues that block critical flows. For example Ledger issues such us \(double charging, no charging, wrong charging, wrong assigning of subscriptions\), Log in issues \(user can't log in, user can't make a contribution\). Expectation of resolving: immediately - On-call schedule applies ### High Priority -These are issues that are impacting critical flows without blocking them or issues not on the critical flows that are widespread for example: Manage subscriptions \(cancel, update\) CSS issues in critical flows or system wide Expectation of resolving: when resuming work, before working on ongoing main projects +These are issues that are impacting critical flows without blocking them or issues not on the critical flows that are widespread. For example: Manage subscriptions \(cancel, update\), CSS issues in critical flows or system wide. Expectation of resolving: when resuming work, before working on ongoing main projects ### Priority @@ -20,11 +20,11 @@ Issues that can wait for a week. Expectation of resolving: within the week. They ### Complexity Labels -Understand the amount of energy and time it the issue needs. Simple: 2hs or less Medium: a day max Complex: +a day +Understand the amount of energy and time it the issue needs. Simple: 2hs or less, Medium: a day max, Complex: +a day ### Area -Backend Frontend Documentation Localisation Design Ledger Tiers Events Expenses Notifications Reporting +Backend, Frontend, Documentation, Localisation, Design, Ledger, Tiers, Events, Expenses, Notifications, Reporting ## Extra Labels: @@ -38,7 +38,7 @@ Good practice for someone new. ### Up for Grabs + Team -Enhancements, improvements, issues that impact the team only To be grabbed by team-members when in between main projects or to do something different every now and then. +Enhancements, improvements, issues that impact the team only. To be grabbed by team-members when in between main projects or to do something different every now and then. Expectation of resolving: within a month. ### Up for Grabs diff --git a/internal/moderation.md b/internal/moderation.md index f2119c35..0d955a2d 100644 --- a/internal/moderation.md +++ b/internal/moderation.md @@ -43,7 +43,7 @@ User has a strange behavior with a feature, or is abusing a specific one. We wan Set `User.data.features.{FEATURE_NAME}` to `false` -To see a list of all features names, check [https://github.com/opencollective/opencollective-api/blob/main/server/constants/features.ts](https://github.com/opencollective/opencollective-api/blob/main/server/constants/features.ts) +To see a list of all features names, check [https://github.com/opencollective/opencollective-api/blob/main/server/constants/feature.ts](https://github.com/opencollective/opencollective-api/blob/main/server/constants/feature.ts) **Example** diff --git a/internal/projects/maintainerati-berlin-2019.md b/internal/projects/maintainerati-berlin-2019.md index 73d04b5d..7c08f68a 100644 --- a/internal/projects/maintainerati-berlin-2019.md +++ b/internal/projects/maintainerati-berlin-2019.md @@ -26,5 +26,5 @@ We don't recommend using the gift card balance for recurring contributions, beca ## I made a mistake or I still have questions.... -Please contact [support@opencollective.com](mailto:support@opencollective.com). +Please contact [https://opencollective.com/support](https://opencollective.com/support). diff --git a/internal/projects/season-of-docs-2019.md b/internal/projects/season-of-docs-2019.md index b22c4591..f3d3ea6c 100644 --- a/internal/projects/season-of-docs-2019.md +++ b/internal/projects/season-of-docs-2019.md @@ -85,7 +85,7 @@ Create video tutorials: _**Project Mentors:** Alanna, Jaskirat_ -**Thanks for your interest in our Season of Docs ideas! If you want to get involved, please email info@opencollective.com and/or** [**join our Slack**](https://slack.opencollective.com)**.** +**Thanks for your interest in our Season of Docs ideas! If you want to get involved, please email** [**info@opencollective.com**](mailto:info@opencollective.com) **and/or** [**join our Slack**](https://slack.opencollective.com)**.** ## **FAQ** diff --git a/internal/support.md b/internal/support.md index 898f6d75..112c505a 100644 --- a/internal/support.md +++ b/internal/support.md @@ -6,7 +6,7 @@ description: Guide to providing support to users of the Open Collective platform ## Support Ticket System -Open Collective uses [FreshDesk](https://opencollective.freshdesk.com) to track support requests. All messages sent to support@opencollective.com automatically create a ticket in the system. +Open Collective uses [FreshDesk](https://opencollective.freshdesk.com) to track support requests. All messages sent to [support@opencollective.com](mailto:support@opencollective.com) automatically create a ticket in the system. Alanna is looking after general support. She triages all incoming tickets and resolves the ones she can. Other team member are also welcome to pick up tickets. The FreshDesk system makes it clear if a response has already been sent. diff --git a/internal/testing.md b/internal/testing.md index 4647df3d..a8516dd7 100644 --- a/internal/testing.md +++ b/internal/testing.md @@ -4,21 +4,11 @@ Tests are intended to be run either on development machines \(`NODE_ENV=developm ## Setup -We use [Mocha](https://mochajs.org/) for unit-testing and [Nightwatch](http://nightwatchjs.org) for end-to-end \(e2e\) testing. To run end-to-end tests on your machine you will have to first install Selenium and the Google Chrome Driver manually. - -### Install Selenium - -Download the [selenium-server-standalone-2.44.0.jar](http://selenium-release.storage.googleapis.com/2.44/selenium-server-standalone-2.44.0.jar) and move it to `bin/selenium-server-standalone-2.44.0.jar` - -On MacOSX Yosemite, you might also need to install Java \(yes, I know... don't look at me this way...\). You can download it from [this page](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html). - -### Install the Chrome Driver - -Download the chrome driver from [https://sites.google.com/a/chromium.org/chromedriver/downloads](https://sites.google.com/a/chromium.org/chromedriver/downloads), unzip it and move it to `test/lib/chromedriver` +We use [Mocha](https://mochajs.org/) for unit-testing and [Cypress](https://www.cypress.io/) for end-to-end \(e2e\) testing. More details on setting up your local machine for tests can be found at, [https://github.com/opencollective/opencollective-frontend/blob/main/docs/e2e.md](https://github.com/opencollective/opencollective-frontend/blob/main/docs/e2e.md). ### Database -Create an `opencollective_test` database accessible to user `opencollective`; each e2e test will reset its schema as required. +Create an `opencollective_test` database accessible to user `opencollective`. ```text $> createdb opencollective_test diff --git a/internal/welcome-document.md b/internal/welcome-document.md index f4b44e63..936d1f8d 100644 --- a/internal/welcome-document.md +++ b/internal/welcome-document.md @@ -3,7 +3,6 @@ description: >- Below you’ll find information to help you get started. Please read carefully & feel free to let us know if something isn’t clear enough or missing. You can email Pia directly at [pia@opencollective.com](pia@opencollective.com). ---- # Welcome Document @@ -35,7 +34,7 @@ Sustainability: We can’t achieve our mission unless we are sustainable doing i Openness: We work in the open, use public slack, our code is public. We strive to be reachable and welcoming. -Resilience \(people come and go\) A successful company survives its founders. We try to do things in a way anyone can pick up after and carry on. +Resilience \(people come and go\): A successful company survives its founders. We try to do things in a way anyone can pick up after and carry on. Transparency: Our[ data](https://drive.google.com/drive/u/1/folders/1OwRpuIehFQxRnJIRAksQ1Jd2xXZrhz5L) is public as well as[ our revenue numbers](https://docs.google.com/spreadsheets/u/1/d/1uNDoafJyI50o128tjV2HjJGrf8l4bGOorJdSL8qgPyk/edit?usp=drive_web&ouid=113376999794383062808), our investors update are regularly published[ in our medium](https://medium.com/open-collective) and our salary tiers are published here. @@ -102,7 +101,7 @@ Features: Features have a template that starts with the user. For example, As a #### Freshdesk -We use Freshdesk to track user support requests. If you receive a support inquiry that can’t be solves immediately \(e.g. on Slack or email\), you can create a Freshdesk ticket for followup. You may be assigned support tickets that relate to projects you’re working on. +We use Freshdesk to track user support requests. If you receive a support inquiry that can’t be solved immediately \(e.g. on Slack or email\), you can create a Freshdesk ticket for followup. You may be assigned support tickets that relate to projects you’re working on. #### Weekly Calls diff --git a/product/currencies.md b/product/currencies.md index b35ec0b8..cb77eaea 100644 --- a/product/currencies.md +++ b/product/currencies.md @@ -4,14 +4,37 @@ Donation amounts will be denominated in the currency of the Collective's [Fiscal Host](../fiscal-hosts/fiscal-hosts.md), which can be set up in the following currencies \(so far\): -* USD -* EUR +* ARS +* AUD +* BDT +* BGN +* BRL * CAD -* MXN +* CHF +* CZK +* DKK +* EUR * GBP -* AUD -* NZD +* HKD +* HRK +* HUF +* INR +* ISK * JPY +* MXN +* MYR +* NGN +* NOK +* NPR +* NZD +* PLN +* RON +* SEK +* SGD +* UAH +* USD +* UYU +* ZAR -**The currency a Fiscal Host supports is determined by the currency used by their Stripe account.** If you would like to set up a Fiscal Host in a different currency, please contact us at **support@opencollective.com**. +**The currency a Fiscal Host supports is determined by the currency used by their Stripe account.** If you would like to set up a Fiscal Host in a different currency, please contact us at [https://opencollective.com/support](https://opencollective.com/support). diff --git a/product/log-in-system.md b/product/log-in-system.md index 96599f82..f7da6167 100644 --- a/product/log-in-system.md +++ b/product/log-in-system.md @@ -26,7 +26,7 @@ According to [Auth0](https://auth0.com/blog/is-passwordless-authentication-more- In 2020, this login system was audited by [Cure53](https://cure53.de). Their report included recommendations for improving it, but they found no critical issue nor design issue about the way it works today. -Our login system is also covered by our [security bounty policy](https://github.com/opencollective/opencollective/blob/main/BOUNTY.md) ; we invite security researchers \(and pay them\) to try to break our system and improve it. +Our login system is also covered by our [security bounty policy](https://github.com/opencollective/opencollective/blob/main/SECURITY.md); we invite security researchers \(and pay them\) to try to break our system and improve it. **Who else uses magic links to login?** diff --git a/product/moderation.md b/product/moderation.md index 6247aea7..4c85614b 100644 --- a/product/moderation.md +++ b/product/moderation.md @@ -14,7 +14,7 @@ Especially, these types of contents are never welcome on the website: ## How to report abusive content -Please send all your reports for spam and abusive content to: [support@opencollective.com](mailto:support@opencollective.com). +Please send all your reports for spam and abusive content to: [https://opencollective.com/support](https://opencollective.com/support). ## Limited user account @@ -26,9 +26,5 @@ When you're account is limited you'll be unable to complete any sensitive action * Make financial contributions * Create conversations -If your account gets limited by mistake, you can contact [support@opencollective.com](mailto:support@opencollective.com). - - - - +If your account gets limited by mistake, you can contact [https://opencollective.com/support](https://opencollective.com/support). diff --git a/product/privacy-policy.md b/product/privacy-policy.md index c29d8300..b7e62fea 100644 --- a/product/privacy-policy.md +++ b/product/privacy-policy.md @@ -87,9 +87,9 @@ Open Collective is GDPR compliant. We are not in the business of selling data to ## Data Removal -If you haven't made any transactions, you can easily delete your profile account on Open Collective from the settings. If your profile or collective has transactions, we can't delete them since we need to keep the integrity of our ledger and accounting system. +If you haven't made any transactions, you can easily delete your profile account on Open Collective from the settings. If your profile or collective has transactions, we can't delete them since we need to keep the integrity of our ledger and accounting system. -For individual / organizations profiles: please contact support@opencollective.com and please request for your personal information to be removed and the transaction\(s\) anonymized. +For individual / organizations profiles: please contact [https://opencollective.com/support](https://opencollective.com/support) and please request for your personal information to be removed and the transaction\(s\) anonymized. For collectives, follow these steps: [http://docs.opencollective.com/collectives/closing-a-collective](http://docs.opencollective.com/collectives/closing-a-collective) diff --git a/product/user-profile.md b/product/user-profile.md index 7a02ac76..346e460b 100644 --- a/product/user-profile.md +++ b/product/user-profile.md @@ -12,6 +12,8 @@ On your **Profile** page, you are able to customize the following: ### Cover image +The optimal size for a cover image is 2736x650. + ![](../.gitbook/assets/screen-shot-2021-03-23-at-8.07.27-pm.jpg) Click on **Edit cover** to access to upload a new cover image.