Skip to content

Commit

Permalink
H-3053: Update references to Discord (#57)
Browse files Browse the repository at this point in the history
* Update README.md

* Update CONTRIBUTING.md

* Update README.md

* Update HashCoreHeaderMenuHelp.tsx

* Update DiscordWidget.tsx

* Update CONTRIBUTING.md

* Update README.md

* Update README.md

* Update README.md

* Update CONTRIBUTING.md
  • Loading branch information
vilkinsons authored Jul 5, 2024
1 parent 818403e commit 257ede2
Show file tree
Hide file tree
Showing 10 changed files with 42 additions and 50 deletions.
20 changes: 8 additions & 12 deletions .github/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,10 @@
# Contributing

Thanks for taking the time to contribute! 🎉 We've established a set of [community guidelines](https://hash.ai/legal/community) to enable as many people as possible to contribute to and benefit from HASH. Please follow these when interacting with this repo.
Thanks for taking the time to contribute! 🎉 We've established a set of [community guidelines](https://hash.ai/legal/trust-safety/community?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide) to enable as many people as possible to contribute to and benefit from HASH. Please follow these when interacting with this repo.

If you'd like to make a significant change or re-architecture to this repository or any project within, please first open a [discussion](https://github.com/hashintel/hash/discussions) or create an [issue](https://github.com/hashintel/hash/issues) to get feedback before spending too much time.
If you'd like to make a significant change or re-architecture to this repository or any project within, please first open a [discussion](https://github.com/hashintel/labs/discussions) or create an [issue](https://github.com/hashintel/labs/issues) to get feedback before spending too much time.

We also have:

- A community [Discord server](https://hash.ai/discord) where you can ask questions about contributing, and obtain helpful advice
- A developer website at [hash.dev](https://hash.dev/), containing developer tutorials, guides and other resources
- A design website at [hash.design](https://hash.design/) containing our Storybook, brand and style guildelines
We also have a developer website at [hash.dev](https://hash.dev/?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide), containing developer tutorials, guides and other resources

## About this repo

Expand All @@ -20,20 +16,20 @@ To ascertain the license and contributing policy for a given project, check out

These apply across all projects:

- Before undertaking any significant work, please share your proposal with us: we don't want you to invest your time on changes we are already working on ourselves, or have different plans for. You can suggest changes as a [discussion](https://github.com/hashintel/hash/discussions) if it's a feature proposal, or an [issue](https://github.com/hashintel/hash/issues) if it's a bug you intend to fix. If you're unsure, you can always chat to us on [Discord](https://hash.ai/discord) first. If it's a typo or docs change, don't worry about this step.
- Before undertaking any significant work, please share your proposal with us: we don't want you to invest your time on changes we are already working on ourselves, or have different plans for. You can suggest changes as a [discussion](https://github.com/hashintel/labs/discussions) if it's a feature proposal, or an [issue](https://github.com/hashintel/labs/issues) if it's a bug you intend to fix. If it's a typo or minor docs change, you can always open a PR directly (don't worry about this step).
- When submitting a pull request, please fill out any sections of the provided template you feel able to. If you are unsure or don't feel a section is relevant, please say so.
- Always include a link to the issue or discussion proposing the change.
- Write tests to accompany your PR, or ask for help/guidance if this is a blocker.
- Make sure that your PR doesn’t break existing tests.
- The repository follows a set of linting rules. Many of them can be applied automatically by running `yarn install` and `yarn fix`.
- Sign our _Contributor License Agreement_ at the CLA Assistant's prompting. (To learn more, read [why we have a CLA](https://hash.ai/legal/cla))
- Sign our _Contributor License Agreement_ at the CLA Assistant's prompting. (To learn more, read [why we have a CLA](https://hash.ai/legal/developers/contributing?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide))
- Once you have receive a pull request review, please bear the following in mind:
- reviewers may make suggestions for _optional_ changes which are not required to get your code merged. It should be obvious which suggestions are optional, and which are required changes. If it is not obvious, ask for clarification.
- please do not resolve comment threads unless you opened them - leave it to the person who raised a comment to decide if any further discussion is required (GitHub will also automatically resolve any code suggestions you click 'commit' on). Comment threads may also be left open so that they can be linked to later.

## How can I find interesting PRs to work on?

Existing issues can provide a good source of inspiration for potential contributions. The issue tags `E-help-wanted` and `E-good-first-issue` flag some of the lower-hanging fruit that are available for people (including first-time contributors) to work on, without necessarily requiring prior discussion. You should also feel free to join our [HASH Discord](https://hash.ai/discord) and reach out directly to us for more inspiration. If you're willing to contribute, we'd love to have you!
Existing issues can provide a good source of inspiration for potential contributions. The issue tags `E-help-wanted` and `E-good-first-issue` flag some of the lower-hanging fruit that are available for people (including first-time contributors) to work on, without necessarily requiring prior discussion. You should also feel free to [reach out directly](https://hash.ai/contact?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide) to us for more inspiration. If you're willing to contribute, we'd love to have you!

## Why might contributions be rejected?

Expand All @@ -42,11 +38,11 @@ There are a number of reasons why otherwise sound contributions might not find t
- **PRs that introduce new functionality without proper tests will not be accepted.** You should write meaningful tests for your code.
- **PRs that fail to pass tests will not be merged.** If your PR doesn’t pass our Continuous Integration tests, it won’t be merged.
- **PRs that duplicate functionality which already exist in HASH, but outside of the project you're introducing them in.** For example, recreating functionality provided in one package directly within another.
- **PRs that duplicate workstreams already under development at HASH** may be rejected, or alternatively integrated into working branches other than those intended by the contributor. For more on these, see our [public roadmap](https://hash.ai/roadmap).
- **PRs that duplicate workstreams already under development at HASH** may be rejected, or alternatively integrated into working branches other than those intended by the contributor. For more on these, see our [public roadmap](https://hash.dev/roadmap?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide).
- **PRs that add functionality that is only useful to a subset of users**, which may increase maintenance overheads on the product. We know it can be frustrating when these sorts of PRs are rejected, and it can sometimes seem arbitrary. We’ll do our best to communicate our rationale clearly in such instances and are happy to talk it out. It's impossible to forecast all of the possible use-cases of a product or feature, and we try to keep an open posture towards such contributions.
- **PRs that introduce architectural changes to the project** (without prior discussion and agreement) will be rejected.
- **PRs that don’t match the syntax, style and formatting of the project will be rejected.** See: _maintainability_.

## Can I work for HASH full-time?

We're recruiting for a number of full-time roles. If you've already contributed to this repo or our [primary `hash` monorepo](https://github.com/hashintel/hash), mention this in your application. View our open roles at [hash.ai/careers](https://hash.ai/careers) and drop your name in the pool even if you can't see a good fit right now.
We're recruiting for a number of full-time roles. If you've already contributed to this repo or our [primary `hash` monorepo](https://github.com/hashintel/hash), mention this in your application. View our open roles at [hash.ai/careers](https://hash.ai/careers?utm_medium=organic&utm_source=github_readme_labs-repo_dot-github-contributing-guide) and drop your name in the pool even if you can't see a good fit right now.
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,10 @@
[discord]: https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_root
[github_star]: https://github.com/hashintel/labs#
[hash]: https://hash.ai/platform/hash?utm_medium=organic&utm_source=github_readme_labs-repo_root
[hash core]: https://hash.ai/platform/core?utm_medium=organic&utm_source=github_readme_labs-repo_root
[hash engine]: https://hash.ai/platform/engine?utm_medium=organic&utm_source=github_readme_labs-repo_root
[repository guidelines]: https://github.com/hashintel/labs/blob/main/.github/CONTRIBUTING.md

[![discord](https://img.shields.io/discord/840573247803097118)][discord] [![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]
[![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]

# Labs

Expand Down
3 changes: 1 addition & 2 deletions apps/sim-core-plugins/process-modeler/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
[discord]: https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core-plugin-pm
[github_star]: https://github.com/hashintel/labs#
[hash]: https://hash.ai/platform/hash?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core-plugin-pm
[hash core]: https://hash.ai/platform/core?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core-plugin-pm
[hash engine]: https://hash.ai/platform/engine?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core-plugin-pm

[![discord](https://img.shields.io/discord/840573247803097118)][discord] [![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]
[![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]

# hCore Business Process Modeling Plugin

Expand Down
3 changes: 1 addition & 2 deletions apps/sim-core/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
[discord]: https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core
[github_star]: https://github.com/hashintel/labs#
[hash]: https://hash.ai/platform/hash?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core
[hash core]: https://hash.ai/platform/core?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core
[hash engine]: https://hash.ai/platform/engine?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-core

[![discord](https://img.shields.io/discord/840573247803097118)][discord] [![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]
[![github_star](https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social)][github_star]

# HASH Core

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,13 @@ import { selectActivityVisible } from "../../features/viewer/selectors";

import "./DiscordWidget.css";

export const DISCORD_URL = "https://discord.gg/BPMrGAhjPh";
export const DISCORD_URL = "https://github.com/hashintel/labs/discussions";

/**
* On 2024-07-02 our Discord was deprecated. As a temporary patch, we're simply
* changing the link here to point to the discussions page in our `labs` GitHub
* repository, to ensure there is some public space users can comment.
*/

/**
* @warning This component specifically does not rely on a Redux store being in
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ export const HashCoreHeaderMenuHelp: FC<HashCoreHeaderMenuHelpProps> = memo(
<ul className="HashCoreHeaderMenu-submenu">
<li className="HashCoreHeaderMenu-submenu-item">
<a
href="https://docs.hash.ai/core/"
href="https://hash.dev/docs/simulation"
target="_blank"
onClick={() =>
dispatch(
Expand All @@ -56,7 +56,7 @@ export const HashCoreHeaderMenuHelp: FC<HashCoreHeaderMenuHelpProps> = memo(
{/* {canUseAccount ? (
<li className="HashCoreHeaderMenu-submenu-item">
<a href={ACCOUNT_URL} target="_blank">
My Account
My account
</a>
</li>
) : null} */}
Expand All @@ -71,15 +71,15 @@ export const HashCoreHeaderMenuHelp: FC<HashCoreHeaderMenuHelpProps> = memo(
tour.start();
}}
>
New User Tour
New user tour
</a>
</li>
) : null}
<li className="HashCoreHeaderMenu-submenu-item">
{/* <li className="HashCoreHeaderMenu-submenu-item">
<a href={DISCORD_URL} target="_blank" rel="noopener noreferrer">
Community Discord
Community forum
</a>
</li>
</li> */}
<li className="HashCoreHeaderMenu-submenu-item">
<a
href={"https://github.com/hashintel/labs/issues/new/choose"}
Expand Down
8 changes: 4 additions & 4 deletions apps/sim-engine/CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
_Thank you for your interest in contributing to the HASH Engine (aka. hEngine)_

We've provided the following guidelines to help you with contributions, in addition to the ones described below, we've
also established a set of [community guidelines](https://hash.ai/legal/community) to enable as many people as possible
also established a set of [community guidelines](https://hash.ai/legal/trust-safety/community?utm_medium=organic&utm_source=github_readme_labs-repo_sim-engine-contributing-guide) to enable as many people as possible
to contribute to and benefit from HASH. Please follow these when interacting with this repo.

## Table Of Contents
Expand All @@ -32,7 +32,7 @@ to contribute to and benefit from HASH. Please follow these when interacting wit
## I have a question, where do I go?

If you have a question, you can ask it on our [community forum](https://hash.community/) or join our public [Discord server](https://hash.ai/discord) (requires a HASH account). Please don't use GitHub issues for general help or discussions. You can also get in touch with us directly via any of the methods outlined on [our site](https://hash.ai/contact).
If you have an issue, you can [open an issue](https://github.com/hashintel/labs/issues) in our [`labs` repository](https://github.com/hashintel/labs). If you have a general question, you can also [create a discussion](https://github.com/hashintel/labs/discussions) in the same repository, although we monitor these less frequently. Finally, you can also get in touch with us directly via any of the methods outlined on [our site](https://hash.ai/contact?utm_medium=organic&utm_source=github_readme_labs-repo_sim-engine-contributing-guide).

## Getting started, what do I need to know?

Expand Down Expand Up @@ -76,7 +76,7 @@ So you've found a bug, next up is collecting useful information to give us to in

### Suggesting Enhancements

If you have ideas of how to improve the hEngine, feel free to submit them on the [Product Feedback section of our community forum](https://community.hash.ai/c/product-feedback/2). If you want a more informal discussion around your ideas feel free to start a conversation on the Discord!
If you have ideas of how to improve the hEngine, feel free to submit them as GitHub issues on this repository.

<!--
The following sections are comments until the wishlist section of the new website is live
Expand Down Expand Up @@ -153,4 +153,4 @@ cargo clippy
### Hiring

**We're growing the team behind HASH.** If you like what we've built, have contributed to the repo, or are otherwise interested in a full-time role, check out our [open opportunities](https://hash.ai/careers).
**We're growing the team behind HASH.** If you like what we've built, have contributed to the repo, or are otherwise interested in a full-time role, check out our [open opportunities](https://hash.ai/careers?utm_medium=organic&utm_source=github_readme_labs-repo_sim-engine-contributing-guide).
7 changes: 1 addition & 6 deletions apps/sim-engine/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,6 @@
</p>
<div align="center">
<a href="https://github.com/hashintel/labs/blob/main/apps/engine/LICENSE.md"><img src="https://cdn-us1.hash.ai/assets/license-badge-elastic.svg" alt="Elastic License v2" /></a>
<a href="https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine"><img src="https://img.shields.io/discord/840573247803097118" alt="Join HASH on Discord" /></a>
<a href="https://github.com/hashintel/labs#"><img src="https://img.shields.io/github/stars/hashintel/labs?label=Star%20on%20GitHub&style=social" alt="Star on GitHub"></a>
</div>

Expand Down Expand Up @@ -44,18 +43,14 @@ Our ultimate intention is to migrate both hCore and hCloud to use the engine und

## Issue Tracking

We use [GitHub Issues](https://github.com/hashintel/labs/issues) to help prioritize and track bugs and feature requests. Please use the [HASH Engine Issue form](https://github.com/hashintel/labs/issues/new?assignees=&labels=A-engine%2CC-bug&template=bug-report-hash-engine.yml) to help us deal with your report most effectively. If you're unsure about something or need help, you can also ask questions and get support on our public [Discord server](https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine).
We use [GitHub Issues](https://github.com/hashintel/labs/issues) to help prioritize and track bugs and feature requests. Please use the [HASH Engine Issue form](https://github.com/hashintel/labs/issues/new?assignees=&labels=A-engine%2CC-bug&template=bug-report-hash-engine.yml) to help us deal with your report most effectively.

## Additional Documentation

Our [user guide for simulation](https://hash.ai/docs/simulation?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine) contains a beginner's introduction as well as in-depth tutorials for **hCore** today.

The [HASH glossary](https://hash.ai/glossary?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine) contains helpful explainers around key modeling, simulation and AI-related terms and concepts.

## Questions & Support

We're building a community of people who care about enabling better decision-making through modeling and simulation. Our [support forum](https://hash.community/?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine) and [HASH community Discord server](https://hash.ai/discord?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine) (requires login) are both great places to meet other modelers and get help.

## The State of Development

As outlined above, this project is the next-generation of our simulation engine, and differs from the one currently powering [hCore](https://hash.ai/platform/core?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine) and [hCloud](https://hash.ai/platform/cloud?utm_medium=organic&utm_source=github_readme_labs-repo_apps-sim-engine). It's published here as a pre-release technology preview, and as such the feature-set and codebase should be considered unstable until it's released. That means that there are a number of features you may use on the HASH platform that at present may not be supported by this project, notably:
Expand Down
Loading

0 comments on commit 257ede2

Please sign in to comment.