Skip to content

Commit 094fd77

Browse files
committed
docs: update, reword, fix dead links
1 parent 0c86d6e commit 094fd77

31 files changed

+623
-419
lines changed

.changeset/README.md

+4-5
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,7 @@
11
# Changesets
22

3-
Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
4-
with multi-package repos, or single-package repos to help you version and publish your code. You can
5-
find the full documentation for it [in our repository](https://github.com/changesets/changesets)
3+
Hello and welcome!
4+
This folder has been automatically generated by `@changesets/cli`, a build tool that works with multi-package repos, or single-package repos to help you version and publish your code.
5+
You can find the full documentation for it [in our repository](https://github.com/changesets/changesets)
66

7-
We have a quick list of common questions to get you started engaging with this project in
8-
[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
7+
We have a quick list of common questions to get you started engaging with this project in [our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

README.md

+56-54
Original file line numberDiff line numberDiff line change
@@ -1,54 +1,56 @@
1-
<p align="center">
2-
<a href="https://www.eslint-config-sheriff.dev">
3-
<img src="https://github.com/AndreaPontrandolfo/sheriff/blob/master/apps/docs-website/static/img/sheriff-logo.svg" width="240">
4-
<h1 align="center">Sheriff</h1>
5-
</a>
6-
<p align="center">
7-
✨ A comprehensive and opinionated Typescript-first ESLint configuration ✨
8-
</p>
9-
</p>
10-
11-
## 🥳 Overview
12-
13-
This repository is a monorepo that hosts the sourcecode of the following projects:
14-
15-
| Link | Source | Description | Version |
16-
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
17-
| [Sheriff docs website](https://www.eslint-config-sheriff.dev) | [docs-website](https://github.com/AndreaPontrandolfo/sheriff/tree/master/apps/docs-website) | Sheriff documentation website | |
18-
| [`eslint-config-sheriff`](https://www.npmjs.com/package/eslint-config-sheriff) | [eslint-config-sheriff](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/eslint-config-sheriff) | A comprehensive and opinionated Typescript-first ESLint configuration | [![npm](https://img.shields.io/npm/v/eslint-config-sheriff.svg)](https://www.npmjs.com/package/eslint-config-sheriff) |
19-
| [`@sherifforg/create-config`](https://www.npmjs.com/package/@sherifforg/create-config) | [sheriff-create-config](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-create-config) | Package used to create Sheriff-based ESLint configs | [![npm](https://img.shields.io/npm/v/@sherifforg/create-config.svg)](https://www.npmjs.com/package/@sherifforg/create-config) |
20-
| [`@sherifforg/cli`](https://www.npmjs.com/package/@sherifforg/cli) | [sheriff-cli](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-cli) | The Sheriff CLI. Used to manage Sheriff-based ESLint configs | [![npm](https://img.shields.io/npm/v/@sherifforg/cli.svg)](https://www.npmjs.com/package/@sherifforg/cli) |
21-
22-
## 🚀 Getting Started
23-
24-
Visit the [official docs](https://www.eslint-config-sheriff.dev) to get started with Sheriff.
25-
26-
## 📝 Updates
27-
28-
You can follow the latest updates on the project in the [official blog](https://www.eslint-config-sheriff.dev/blog).
29-
30-
## 🧡 Contributing
31-
32-
### Suggestions
33-
34-
I consider Sheriff a community effort, and I welcome suggestions and contributions of any kind.
35-
Feel free to propose suggestions about new rules to implement, or tweaks to existing rules.<br>
36-
Please use the discussions tab or the issues tab for new rules proposals.
37-
38-
### Development
39-
40-
1. Clone this repository
41-
1. Enable Corepack using `corepack enable`
42-
1. Install dependencies using `pnpm install`
43-
1. Do the changes
44-
45-
## 🌤 Changelog
46-
47-
[Releases](https://github.com/AndreaPontrandolfo/sheriff/releases).
48-
49-
## 💌 Acknowledgments
50-
51-
For some of this configuration, [eslint-config-red](https://github.com/GrosSacASac/JavaScript-Set-Up/blob/master/js/red-javascript-style-guide/index.js) was partially used as a base.<br>
52-
Additionally, inspiration was drawn from [eslint-config-airbnb](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb) for some of the rules in `no-restricted-syntax`.<br>
53-
I don't take any attribution for the rules in the various eslint-plugins used here (except for the few that I personally created). Please consider starring the respective projects for the awesome work their authors made. Sheriff wouldn't be possible without their efforts.<br>
54-
The full list of the plugins used is [here](https://www.eslint-config-sheriff.dev/docs/eslint-plugins).
1+
<p align="center">
2+
<a href="https://www.eslint-config-sheriff.dev">
3+
<img src="https://github.com/AndreaPontrandolfo/sheriff/blob/master/apps/docs-website/static/img/sheriff-logo.svg" width="240">
4+
<h1 align="center">Sheriff</h1>
5+
</a>
6+
<p align="center">
7+
✨ A comprehensive and opinionated TypeScript-first ESLint configuration ✨
8+
</p>
9+
</p>
10+
11+
## 🥳 Overview
12+
13+
This repository is a monorepo that hosts the sourcecode of the following projects:
14+
15+
| Link | Source | Description | Version |
16+
| -------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
17+
| [Sheriff docs website](https://www.eslint-config-sheriff.dev) | [docs-website](https://github.com/AndreaPontrandolfo/sheriff/tree/master/apps/docs-website) | Sheriff documentation website | |
18+
| [`eslint-config-sheriff`](https://www.npmjs.com/package/eslint-config-sheriff) | [eslint-config-sheriff](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/eslint-config-sheriff) | A comprehensive and opinionated TypeScript-first ESLint configuration | [![npm](https://img.shields.io/npm/v/eslint-config-sheriff.svg)](https://www.npmjs.com/package/eslint-config-sheriff) |
19+
| [`@sherifforg/create-config`](https://www.npmjs.com/package/@sherifforg/create-config) | [sheriff-create-config](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-create-config) | Package used to create Sheriff-based ESLint configs | [![npm](https://img.shields.io/npm/v/@sherifforg/create-config.svg)](https://www.npmjs.com/package/@sherifforg/create-config) |
20+
| [`@sherifforg/cli`](https://www.npmjs.com/package/@sherifforg/cli) | [sheriff-cli](https://github.com/AndreaPontrandolfo/sheriff/tree/master/packages/sheriff-cli) | The Sheriff CLI. Used to manage Sheriff-based ESLint configs | [![npm](https://img.shields.io/npm/v/@sherifforg/cli.svg)](https://www.npmjs.com/package/@sherifforg/cli) |
21+
22+
## 🚀 Getting Started
23+
24+
Visit the [official docs](https://www.eslint-config-sheriff.dev) to get started with Sheriff.
25+
26+
## 📝 Updates
27+
28+
You can follow the latest updates on the project in the [official blog](https://www.eslint-config-sheriff.dev/blog).
29+
30+
## 🧡 Contributing
31+
32+
### Suggestions
33+
34+
I consider Sheriff a community effort, and I welcome suggestions and contributions of any kind.
35+
Feel free to propose suggestions about new rules to implement, or tweaks to existing rules.<br />
36+
Please use the discussions tab or the issues tab for new rules proposals.
37+
38+
### Development
39+
40+
1. Clone this repository (`git clone https://github.com/AndreaPontrandolfo/sheriff.git`)
41+
2. Enable Corepack via `corepack enable`
42+
3. Install the dependencies via `pnpm install`
43+
4. Make, commit, push, and PR your changes
44+
45+
## 🌤 Changelog
46+
47+
See the [releases](https://github.com/AndreaPontrandolfo/sheriff/releases) page.
48+
49+
## 💌 Acknowledgments
50+
51+
For some of this configuration, [eslint-config-red](https://github.com/GrosSacASac/JavaScript-Set-Up/blob/master/js/red-javascript-style-guide/index.js) was partially used as a base.<br />
52+
Additionally, inspiration was drawn from [eslint-config-airbnb](https://github.com/airbnb/javascript/tree/master/packages/eslint-config-airbnb) for some of the rules in `no-restricted-syntax`.<br />
53+
I don’t take any attribution for the rules in the various ESLint plugins used here (except for the few that I personally created).
54+
Please consider starring the respective projects for the awesome work their authors made.
55+
Sheriff wouldn’t be possible without their efforts.<br />
56+
The full list of the plugins used is [here](https://www.eslint-config-sheriff.dev/docs/eslint-plugins).

apps/docs-website/blog/2023-08-16-sheriff-reboot.mdx

+26-16
Original file line numberDiff line numberDiff line change
@@ -22,46 +22,56 @@ import useBaseUrl from "@docusaurus/useBaseUrl";
2222
## Sheriff release v14
2323

2424
Sheriff, the ESLint sharable config, has exciting news to share!<br />
25-
With a complete rebranding, a restructured codebase, and exciting plans ahead, Sheriff is set to become an even more essential tool for ensuring code quality and consistency in projects.<br />
26-
Let's walkthrough the key changes of this release.
25+
With a complete rebranding, a restructured codebase, and exciting plans,
26+
Sheriff is set to become an even more essential tool for ensuring code quality and consistency in projects.<br />
27+
Let’s walkthrough the key changes of this release.
2728

2829
## Restructured Codebase in a monorepo
2930

30-
The codebase has been restructured into a monorepo setup with [Turborepo](https://turbo.build/repo) + [pnpm workspaces](https://pnpm.io/workspaces), as it allows for the management of multiple related packages under a single repository, streamlining the development process and enabling better coordination between different parts of the project.
31-
32-
As a side-effect, the project now relies on [changesets](https://github.com/changesets/changesets) to manage semantic versioning, in place of [semantic-release](https://github.com/semantic-release/semantic-release).
31+
The codebase has been restructured into a monorepo with [Turborepo](https://turbo.build/repo) + [pnpm workspaces](https://pnpm.io/workspaces).
32+
This allows for the management of multiple related packages under a single repository,
33+
streamlining the development process and enabling better coordination between different parts of the project.
34+
Also, the project now uses [changesets](https://github.com/changesets/changesets)
35+
to manage semantic versioning in place of [semantic-release](https://github.com/semantic-release/semantic-release).
3336

3437
## Complete Rebranding
3538

3639
### New Docs
3740

38-
The documentation has been fully revamped, moving on from [Gitbook](https://www.gitbook.com/) to [Docusaurus](https://docusaurus.io/), a modern documentation framework.<br/>
39-
Whether a newcomer or a seasoned user, the documentation is more accessible and easier to navigate, with a sidebar that allows for quick access to the different sections.<br/>
40-
Also, a special [Rules page](https://www.eslint-config-sheriff.dev/docs/rules) was carefully crafted to let users explore in detail all the rules that Sheriff enables.
41+
The documentation has been fully revamped, moving on from [GitBook](https://www.gitbook.com/) to [Docusaurus](https://docusaurus.io/), a modern documentation framework.<br />
42+
Whether a newcomer or a seasoned user, the documentation is more accessible and easier to navigate, with a sidebar that allows for quick access to the different sections.<br />
43+
Also, a special [rules page](https://www.eslint-config-sheriff.dev/docs/rules) was carefully crafted to let users explore all the rules that Sheriff enables in detail.
4144

4245
Visit the new docs at this [link](https://www.eslint-config-sheriff.dev).
4346

4447
### New Logo
4548

46-
The beginning of a fresh era for Sheriff is marked by a new logo, that features the iconic ESLint logo and a shield.
49+
The beginning of a fresh era for Sheriff is marked by a new logo that features the iconic ESLint logo and a shield.
4750

4851
![Sheriff Logo](/img/sheriff-logo.svg)
4952

5053
### New Blog
5154

52-
A [brand-new blog](https://www.eslint-config-sheriff.dev/blog) is now available, where I'll keep sharing updates on the projects as it grows along.
55+
A [brand-new blog](https://www.eslint-config-sheriff.dev/blog) is now available,
56+
where we will keep sharing updates as it continues to grow.
57+
If you want, you can even [subscribe via RSS](https://www.eslint-config-sheriff.dev/)!
5358

54-
## What's Next
59+
## Whats Next
5560

56-
The focus remains on continuously improving the tool, making it more adaptable, and responding to the evolving needs of the development community.<br />
61+
The focus remains on continuous improvement,
62+
making it more adaptable,
63+
and responding to the evolving needs of the development community.<br />
5764
Looking ahead, several exciting developments are in store:
5865

59-
- **Astro Support**: In the continuous effort to integrate more eslint-plugins into Sheriff, the next in line is [eslint-plugin-astro](https://github.com/ota-meshi/eslint-plugin-astro).
66+
- **Astro Support**: In the continuous effort to integrate more ESLint plugins into Sheriff, the next in line is [eslint-plugin-astro](https://github.com/ota-meshi/eslint-plugin-astro).
6067
- **Searchbar**: full-text search, powered by [Algolia](https://www.algolia.com/) in the new docs.
61-
- **Ask AI**: along with the new searchbar will come an "Ask AI bot" feature. Details on this one are still being worked on.
68+
- **Ask AI**: along with the new searchbar will come an “Ask AI bot” feature.
69+
Details still being worked out.
6270

6371
## Conclusion
6472

65-
With this much-needed facelift, Sheriff is ready to keep growing. With a new documentation hub powered by Docusaurus, logo, and blog in place, Sheriff is set to provide an even more exceptional ESLint sharable config experience.<br/>
66-
If you want to help feel free to propose new features, both for the config and the docs, or report any bug you might come across.<br/>
73+
With this much-needed facelift, Sheriff is ready to keep growing.
74+
With a new documentation hub powered by Docusaurus, logo, and blog in place,
75+
Sheriff is set to provide an even more exceptional ESLint sharable config experience.<br />
76+
If you want to help feel free to propose new features, both for the config and the docs, or report any bug you might come across.<br />
6777
Stay tuned for updates and insights on the new blog!

0 commit comments

Comments
 (0)