<commit_before>First of all, thank you for contributing to [Homebrew/science](https://github.com/Homebrew/homebrew-science). The following guidelines are designed to help you write more efficient pull requests and/or issues.

* [Issues](#issues)
* [Formula Guidelines](#formula)
* [Submitting a Pull Request](#pull)
* [Useful Snippets and Notes](#notes)

<a name="issues"/>
## Issues

#### First, please read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/wiki/troubleshooting).

See also Homebrew's [FAQ](https://github.com/Homebrew/homebrew/wiki/FAQ) and [Common Issues](https://github.com/Homebrew/homebrew/wiki/Common-Issues).

#### New Issues

* Search [open](https://github.com/Homebrew/homebrew-science/issues?state=open) and [closed](https://github.com/Homebrew/homebrew-science/issues?page=1&state=closed) issues before submitting a new issue. Duplicates will be closed.
* Strictly one formula per issue unless your issue is about different formulae interacting negatively.
* Give the full `brew` command that you used and that caused the error to emerge.
* **If a formula fails to brew, always [gist](https://gist.github.com) the full logs with `brew gist-logs <formula>`.**

<a name="formula"/>
## Formula Guidelines

Please first read Homebrew's [Formula Cookbook](https://github.com/Homebrew/homebrew/wiki/Formula-Cookbook) and [Acceptable Formulae](https://github.com/Homebrew/homebrew/wiki/Acceptable-Formulae). This section lists additional guidelines that should be followed in Homebrew/science.

#### Tests

We insist that formulae in Homebrew/science always be accompanied by tests. Not all formulae currently in Homebrew/science have meaningful tests but the idea is to improve them over time.

Tests can be in the form of a `make test` or `make check`, a `test` method, or (if possible) both. If your package doesn't provide tests, that should be specified in the pull request. Meaningful tests are preferred over simple commands like `system "foo", "-v"`.

Whenever install-time tests in the form of `make test` or `make check` take more than a few seconds, an option offering to disable tests should be included. Running the tests by default is preferable. Use the option `without-check` to disable your build-time tests. See [Testing / Checking](#testing--checking).

#### Logical Guidelines

* **Patches should be submitted upstream. Describe and link to the issue in your comments.**
* Group mandatory, optional, and recommended dependencies together.
* Group other options together.

#### Stylistic Guidelines

* Follow the [GitHub Ruby Styleguide](https://github.com/styleguide/ruby).
* Use inline `if` and `unless` whevener possible and reasonable (e.g., `depends_on "foo" if build.with? "bar"`, `system "make", "check" if build.with? "check"`).<commit_msg>CONTRIBUTING: update core doc links<commit_after>First of all, thank you for contributing to [Homebrew/science](https://github.com/Homebrew/homebrew-science). The following guidelines are designed to help you write more efficient pull requests and/or issues.

* [Issues](#issues)
* [Formula Guidelines](#formula)
* [Submitting a Pull Request](#pull)
* [Useful Snippets and Notes](#notes)

<a name="issues"/>
## Issues

#### First, please read the [Troubleshooting Checklist](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Troubleshooting.md#troubleshooting).

See also Homebrew's [FAQ](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/FAQ.md#faq) and [README](https://github.com/Homebrew/homebrew/tree/master/share/doc/homebrew#readme).

#### New Issues

* Search [open](https://github.com/Homebrew/homebrew-science/issues?state=open) and [closed](https://github.com/Homebrew/homebrew-science/issues?page=1&state=closed) issues before submitting a new issue. Duplicates will be closed.
* Strictly one formula per issue unless your issue is about different formulae interacting negatively.
* Give the full `brew` command that you used and that caused the error to emerge.
* **If a formula fails to brew, always [gist](https://gist.github.com) the full logs with `brew gist-logs <formula>`.**

<a name="formula"/>
## Formula Guidelines

Please first read Homebrew's [Formula Cookbook](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Formula-Cookbook.md) and [Acceptable Formulae](https://github.com/Homebrew/homebrew/blob/master/share/doc/homebrew/Acceptable-Formulae.md). This section lists additional guidelines that should be followed in Homebrew/science.

#### Tests

We insist that formulae in Homebrew/science always be accompanied by tests. Not all formulae currently in Homebrew/science have meaningful tests but the idea is to improve them over time.

Tests can be in the form of a `make test` or `make check`, a `test` method, or (if possible) both. If your package doesn't provide tests, that should be specified in the pull request. Meaningful tests are preferred over simple commands like `system "foo", "-v"`.

Whenever install-time tests in the form of `make test` or `make check` take more than a few seconds, an option offering to disable tests should be included. Running the tests by default is preferable. Use the option `without-check` to disable your build-time tests. See [Testing / Checking](#testing--checking).

#### Logical Guidelines

* **Patches should be submitted upstream. Describe and link to the issue in your comments.**
* Group mandatory, optional, and recommended dependencies together.
* Group other options together.

#### Stylistic Guidelines

* Follow the [GitHub Ruby Styleguide](https://github.com/styleguide/ruby).
* Use inline `if` and `unless` whevener possible and reasonable (e.g., `depends_on "foo" if build.with? "bar"`, `system "make", "check" if build.with? "check"`).
{'fraction_non_alphanumeric': 0.11337711717939855, 'fraction_numerical': 0.0003456619426201175, 'mean_word_length': 5.130296610169491, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 20, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6460985', 'n_tokens_mistral': 1651, 'n_tokens_neox': 1579, 'n_words': 624}