elisabethfox/hexlet-correction

Typo Reporter

Hexlet Typo Reporter

A service to notify site owners of errors and typos. After integrating with the site, visitors are able to highlight an error or typo and report it to the administrator. The project works in Java.

Tasks can be discussed in the Telegram community.

Example

Go to: https://hexlet.github.io/hexlet-correction/index.html

Highlight text and press Ctrl+Enter

Development

Before you can build this project, you must install and configure the following dependencies on your machine:

1. Java 19
2. Docker, Docker Compose

Packaging as uber-jar

To build the final jar:

make build

Development with vagrant

Install Vagrant and VM provider (Virtualbox).

Run commands:

make vagrant-build
make vagrant-run

or just vagrant ssh, then cd /vagrant to run commands inside vm

Testing

To launch your application's tests, run:

make test

Using Docker to simplify development (optional)

For example, to start a postgresql database in a docker container, run:

make docker-infra-start

Run application with database in docker

make run-dev

Build and run application with database in docker

make run-dev-docker-db # make start

Clear config (database, app build)

make clear

Typo API calls

For creating new typo:

POST http://localhost:8080/api/workspaces/typos
Content-Type: application/json
Authorization: Basic base64(workspaceId:api-token)

{
    "pageUrl": "https://mysite.com/page/with/typo",
    "reporterName": "reporterName",
    "reporterComment": "reporterComment",
    "textBeforeTypo": "textBeforeTypo",
    "textTypo": "textTypo",
    "textAfterTypo": "textAfterTypo"
}

---

This repository is created and maintained by the team and the community of Hexlet, an educational project. Read more about Hexlet.

See most active contributors on hexlet-friends.