From 8830ddfd56667bdc8f27cc12d3c70653a2896caf Mon Sep 17 00:00:00 2001 From: Kyle Carberry Date: Wed, 25 Jan 2023 14:49:15 -0600 Subject: [PATCH] docs: update the readme to reduce unnecessary text (#5837) The README was starting to get quite large, and I felt it was a bit bloaty. - Removes Twitter badge (the API was removed, so it wasn't working anyways) - Adds tagline to the title (an experiment, but worth a shot) - Reduces highlights - Removes recommended reading (people want to get started asap on a repo) - Updates doc links `/docs/coder-oss` -> `/docs/v2` - Moves comparison to the bottom - Removes adopters.md (we never promoted this, so it hasn't been used) --- ADOPTERS.md | 13 ------------- README.md | 54 ++++++++++++++++++----------------------------------- 2 files changed, 18 insertions(+), 49 deletions(-) delete mode 100644 ADOPTERS.md diff --git a/ADOPTERS.md b/ADOPTERS.md deleted file mode 100644 index 89efa5c2d1..0000000000 --- a/ADOPTERS.md +++ /dev/null @@ -1,13 +0,0 @@ -# Adopters - -[!["Join us on -Discord"](https://img.shields.io/badge/join-us%20on%20Discord-gray.svg?longCache=true&logo=discord&colorB=green)](https://coder.com/chat?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=adopters.md) [![Twitter -Follow](https://img.shields.io/twitter/follow/coderhq?label=%40coderhq&style=social)](https://twitter.com/coderhq) - -🦩 _If you're using Coder in your organization, please try to add your company name to this list. It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact. You can do this by by editing this file and contributing your changes via a pull-request on GitHub._ - -> 👋 _If you are considering using Coder in your organization please introduce yourself via https://coder.com/demo_ 🙇🏻‍♂️ - -| Organization | Contact | Description of Use | -| ------------------------------ | --------------------------------------- | ------------------------------ | -| [Coder](https://www.coder.com) | [@coderhq](https://twitter.com/coderhq) | Coder builds coder with Coder. | diff --git a/README.md b/README.md index 2474afbfc6..1976379acb 100644 --- a/README.md +++ b/README.md @@ -1,13 +1,11 @@ -# Coder +# Coder — Your Self-Hosted Remote Development Platform [!["Join us on Discord"](https://img.shields.io/badge/join-us%20on%20Discord-gray.svg?longCache=true&logo=discord&colorB=green)](https://coder.com/chat?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md) [![codecov](https://codecov.io/gh/coder/coder/branch/main/graph/badge.svg?token=TNLW3OAP6G)](https://codecov.io/gh/coder/coder) [![Go Reference](https://pkg.go.dev/badge/github.com/coder/coder.svg)](https://pkg.go.dev/github.com/coder/coder) -[![Twitter -Follow](https://img.shields.io/twitter/follow/coderhq?label=%40coderhq&style=social)](https://twitter.com/coderhq) -Software development on your infrastructure. Offload your team's development from local workstations to cloud servers. Onboard developers in minutes. Build, test and compile at the speed of the cloud. Keep your source code and data behind your firewall. +Offload your team's development from local workstations to cloud servers. Onboard developers in minutes. Build, test and compile at the speed of the cloud. Keep your source code and data behind your firewall. > "By leveraging Terraform, Coder lets developers run any IDE on any compute platform including on-prem, AWS, Azure, GCP, DigitalOcean, Kubernetes, Docker, and more, with workspaces running on Linux, Windows, or Mac." - **Kevin Fishner Chief of Staff at [HashiCorp](https://hashicorp.com/)** @@ -15,27 +13,13 @@ Software development on your infrastructure. Offload your team's development fro

-**Manage less** - -- Ensure your entire team is using the same tools and resources - - Rollout critical updates to your developers with one command -- Automatically shut down expensive cloud resources -- Keep your source code and data behind your firewall - -**Code more** +## Highlights - Build and test faster - Leveraging cloud CPUs, RAM, network speeds, etc. - Access your environment from any place on any client (even an iPad) - Onboard instantly then stay up to date continuously -## Recommended Reading - -- [How our development team shares one giant bare metal machine](https://coder.com/blog/how-our-development-team-shares-one-giant-bare-metal-machine?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md) -- [Laptop development is dead: why remote development is the future](https://medium.com/@elliotgraebert/laptop-development-is-dead-why-remote-development-is-the-future-f92ce103fd13) -- [Learn how Palantir improved build times by 78% with coder](https://blog.palantir.com/the-benefits-of-remote-ephemeral-workspaces-1a1251ed6e53). -- [A software development environment is not just a container](https://coder.com/blog/not-a-container?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md). - ## Getting Started The easiest way to install Coder is to use our @@ -73,18 +57,30 @@ coder server coder server --postgres-url --access-url ``` -> 1 The embedded database is great for trying out Coder with small deployments, but do consider using an external database for increased assurance and control. +> 1 The automatic setup is great for trying out Coder with small deployments, but do consider using an external database for increased assurance and control. -Use `coder --help` to get a complete list of flags and environment variables. Use our [quickstart guide](https://coder.com/docs/coder-oss/latest/quickstart) for a full walkthrough. +Use `coder --help` to get a complete list of flags and environment variables. Use our [quickstart guide](https://coder.com/docs/v2/latest/quickstart) for a full walkthrough. ## Documentation -Visit our docs [here](https://coder.com/docs/coder-oss). +Visit our docs [here](https://coder.com/docs/v2). ## Templates Find our templates [here](./examples/templates). +## Community and Support + +Join our community on [Discord](https://coder.com/chat?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md) and [Twitter](https://twitter.com/coderhq)! + +[Suggest improvements and report problems](https://github.com/coder/coder/issues/new/choose) + +## Contributing + +Read the [contributing docs](https://coder.com/docs/v2/latest/CONTRIBUTING). + +Find our list of contributors [here](https://github.com/coder/coder/graphs/contributors). + ## Comparison Please file [an issue](https://github.com/coder/coder/issues/new) if any information is out of date. Also refer to: @@ -107,17 +103,3 @@ Please file [an issue](https://github.com/coder/coder/issues/new) if any informa | [Microsoft DevBox](https://coder.com/blog/the-self-hosting-paradox?utm_source=github.com/coder/coder?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md) | Platform | SaaS (Preview, not GA) | Pay Microsoft | Yes | Australia East, Europe West, Japan East, Canada Central, UK South, US East, US East 2, US South Central, and US West 3 | Microsoft Azure Virtual Machine | N/A | Not generally available, offered in preview mode. | Windows Virtual Machine | Any application that runs on Windows via Microsoft Remote Desktop | _Last updated: 14/12/2022_ - -## Community and Support - -Join our community on [Discord](https://coder.com/chat?utm_source=github.com/coder/coder&utm_medium=github&utm_campaign=readme.md) and [Twitter](https://twitter.com/coderhq)! - -[Suggest improvements and report problems](https://github.com/coder/coder/issues/new/choose) - -## Contributing - -If you're using Coder in your organization, please try to add your company name to the [ADOPTERS.md](./ADOPTERS.md). It really helps the project to gain momentum and credibility. It's a small contribution back to the project with a big impact. - -Read the [contributing docs](https://coder.com/docs/coder-oss/latest/CONTRIBUTING). - -Find our list of contributors [here](https://github.com/coder/coder/graphs/contributors).