An open API service indexing awesome lists of open source software.

https://github.com/test-prof/docs-ru

Документация на русском языке
https://github.com/test-prof/docs-ru

Last synced: 20 days ago
JSON representation

Документация на русском языке

Awesome Lists containing this project

README

          

# TestProf по-русски

Здесь когда-нибудь будет русскоязычная документация для [TestProf][].

Посмотреть её можно будет [на основном сайте](https://test-prof.evilmartians.io/).

[Инструкция по локализации](https://github.com/test-prof/docs/blob/master/TRANSLATIONS.md).

## Linters

We try to keep our documentation both correct and _stylish_ using the following tools:

- [mdl](https://github.com/markdownlint/markdownlint)—Markdown linter, Ruby edition.
- [liche](https://github.com/raviqqe/liche)—links linter.
- [forspell](https://github.com/kkuprikov/forspell)—spell-checker for English.
- [yaspeller](https://github.com/hcodes/yaspeller)—spell-checker for Russian.
- RuboCop with [rubocop-md](https://github.com/rubocop-hq/rubocop-md) and [standard](https://github.com/testdouble/standard)—Ruby code snippets style checking.

To run these tools locally we use [Lefthook](https://github.com/Arkweid/lefthook) (runs linters automatically for every commit).

To sum up:

- Install `mdl`:

```sh
gem install mdl
```

- Install `liche`:

```sh
go get -u github.com/raviqqe/liche
```

- Install Hunspell and Forspell:

```sh
# for MacOS (for other OS see Forspell documentation)
brew install hunspell

gem install forspell
```

- Install [yaspeller](https://github.com/hcodes/yaspeller):

```sh
npm install -g yaspeller
```

- Install StandardRB and `rubocop-md`:

```sh
gem install standard
gem install rubocop-md
```

- Install `lefthook`:

```sh
# for MacOS (for other OS see Lefthook documentation)
brew install lefthook
```

- Initialize `lefthook`:

```sh
lefthook install
```

Or you can skip all of these and rely on our CI, which can do all the checks for you!

[TestProf]: https://github.com/test-prof/test-prof