Skip to content

chore: add all missing README files to repo #85

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
May 9, 2025
Merged

Conversation

Parkreiner
Copy link
Member

@Parkreiner Parkreiner commented May 8, 2025

Changes made

  • Fleshed out main top-level README file
  • Added formal docs for code of conduct and security (that just lead to the Coder Docs)
  • Revamped contributing guide
  • Added a few images to help support the new docs

Notes

  • Just because we're not supporting templates for the moment, I did deliberately limit the number of mentions to it.

@Parkreiner Parkreiner self-assigned this May 8, 2025
```tf
module "cursor" {
count = data.coder_workspace.me.start_count
source = "registry.coder.com/modules/cursor/coder"
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
source = "registry.coder.com/modules/cursor/coder"
source = "registry.coder.com/coder/cursor/coder"

Shouldn't it be this now?

Copy link
Member Author

@Parkreiner Parkreiner May 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, good call. I ended up copying that snippet directly from the README, but now that you're calling it out, all the current README files still have the old path

@bcpeinhardt Just making sure: I just need to update all the README files to follow the pattern Atif suggested, right? If so, I can go ahead and make a PR to update all the module READMEs

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes. The old path will still work, because we've added a shim to avoid breaking peoples workspace builds, but yeah the namespace is now "coder" not "modules"

CONTRIBUTING.md Outdated

Once Bun (and possibly Go) have been installed, clone this repository. From there, you can run this script to make it easier to start contributing a new module or template:
All Coder resources are scoped to namespaces placed at the top level of the `/registry` directory. Any modules or templates must be placed inside a namespace to be accepted as a contribution. For example, all modules created by TheJonkler would be placed under `/registry/thejonkler/modules`, with a subdirectory for each individual module the user has published.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's use an example that isn't close to anything real just to be safe

CONTRIBUTING.md Outdated
- `avatar_url` (optional string) – A relative/absolute URL pointing to your avatar for the Registry site. It is strongly recommended that you commit avatar images to this repo and reference them via a relative URL.
- `linkedin` (optional string) – A URL pointing to your LinkedIn page.
- `support_email` (optional string) – An email for users to reach you at if they need help with a published module/template.
- `status` (optional string union) – If defined, this must be one of `"community"`, `"partner"`, or `"official"`. `"community"` is treated as the default value if not specified, and should be used for the majority of external contributions. `"partner"` is for companies who have a formal business partnership with Coder. `"official"` should be used only by Coder and Coder satellite companies.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of an implicit default, can we have an explicit set and fail if missing?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do we need "and Coder satellite companies"?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Addressed both of these, and updated the script, too

@Parkreiner
Copy link
Member Author

Addressed all the feedback. I don't want to update the source URLs now, since we haven't pushed the latest changes to the production Registry site, but I went ahead and made a separate PR to handle that.

@Parkreiner Parkreiner merged commit 31b8312 into main May 9, 2025
3 checks passed
@Parkreiner Parkreiner deleted the mes/new-readme-files branch May 9, 2025 22:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants