Increased productivity with IntelliJs Issue Navigation

dacbreakpoint — Thu, 26 May 2022 10:06:59 +0000

Today I want to present you a handy feature within IntelliJ IDEA that will make your everyday work easier when trying to understand specific code parts.

It enables you to navigate directly from the Version Control or Annotate-Sidebar to the corresponding JIRA-Page by simply clicking at the ticket-id, when the id-pattern is detected.

Use Case

When working in a corporate environment, bigger team or project, you probably use an Issue Tracking Software like Atlassian JIRA. Depending on how strict your commit rules are, you will have to write the ticket number within the commit messages. This common practice will help other people to understand the context of the change better. Furthermore, when looking at a ticket, there is a detailed description and maybe a discussion within the comment section, which will help to understand why certain decisions were made.

During software development, you will stumble across code that you want to understand in more detail. Therefore you are probably using the Annotate with Git Blame feature to get more insights of the current line or section. When there is a ticket number in the commit message, you probably copy it out, navigate manually to JIRA, and paste the ticket number into the search bar.
IntelliJ´s Issue Navigation feature is the solution for this manual and annoying process. It maps the ticket-id with the JIRA page and makes the ticket-ids clickable across the whole IDE.

Improves your productivity
Well integrated into the IDE
It makes the everyday work easier

Configuration

You can enable and configure the issue navigation within the settings menu.
It is possible to check if your expression is working by entering your ticket-id in the Example section and you will see if the issue link is generated correctly.

Expression: [A-Za-z\d]+-\d+

Link: https://example.atlassian.net/browse/$0

Thank you for reading! If you know other less-known tips or have feedback to share, feel free to write it in the comments.
You’re also welcome to share this guide with other friends and colleagues. Thanks!

Setup your private LanguageTool server

dacbreakpoint — Sun, 22 May 2022 17:04:46 +0000

General

This year I started my new job in my first English-speaking company. As a senior software engineer, I have to write many emails, complex task- and bug descriptions and create presentations about various topics. Therefore it is great to have an assistant to improve my grammar and spelling.

When looking at some great applications I stumbled across LanguageTool - an open-source grammar, style and spell checker. To increase your privacy and be the owner of your data, it is possible to host your own instance.

This blog post will guide you through the setup and configuration.

LanguageTool and Grammarly

From time to time, I also write emails that contain sensitive information and I developed an awareness of how often these tools are going to process this critical information. I was getting the uncomfortable feeling that this data could be intercepted or used in some way I did not want.

When using closed source software, you have to trust the company and as soon as they store the data on their server - the data is out of my hand. When writing a blog post about LanguageTool, I have to be fair and mention Grammarly. From my personal experience, it is much more powerful and the premium features "readability" and "fluency" are really good. The Privacy Policy from Grammarly says that they don't sell my "information".

LanguageTool comes with its own embedded HTTP server so that a text can send to your own instance of LanguageTool. It is also possible to write your own application and use the HTTP API.

Installation

Docker Compose

I like to host every application within a dedicated docker-compose file. When doing so, the HTTP reverse proxy traefik integrates very well with docker and enables you a dynamic configuration - it is worth taking a look!

Prerequisites

Infrastructure with docker, docker-compose and traefik
Approximately 20 GB of free storage
Prepare your n-gram datasets
- Download the n-gram datasets onto your server - I am using the de and en dataset for my daily work which is consuming 18 GB in total! "n-gram" data sets are used to detect errors with words. For more information, see here and here.

Ensure that you have the following folder structure:

├── languagetool # base folder
│   ├── docker-compose.yml # configuration file
│   └── ngrams
│       ├── de # downloaded n-gram data for de
│       │   ├── 1grams
│       │   ├── 2grams
│       │   └── 3grams
│       └── en
│           ├── 1grams
│           ├── 2grams
│           └── 3grams

docker-compose.yml

Following, you can see my personal docker-compose.yml, which you can use as a reference. For a more detailed description, you can look at the image description erikvl87/languagetool.

version: "3"
services:
  languagetool:
    container_name: languagetool
    image: erikvl87/languagetool
    restart: unless-stopped
    environment:
      - langtool_languageModel=/ngrams  # OPTIONAL: Using ngrams data
      - Java_Xms=512m  # OPTIONAL: Setting a minimal Java heap size of 512 mib
      - Java_Xmx=1g  # OPTIONAL: Setting a maximum Java heap size of 1 Gib
    volumes:
      - ./ngrams:/ngrams
    ports:
      - 8010
    labels:
      - traefik.enable=true
      - traefik.http.services.languagetool.loadbalancer.server.port=8010
      - traefik.http.routers.languagetool-http.rule=Host(`languagetool.example.com`)
      - traefik.http.routers.languagetool-http.entrypoints=web
      - traefik.http.routers.languagetool-http.middlewares=resecure@file
      - traefik.http.routers.languagetool-https.rule=Host(`languagetool.example.com`)
      - traefik.http.routers.languagetool-https.entrypoints=websecure
      - traefik.http.routers.languagetool-https.tls=true
      - traefik.http.routers.languagetool-https.tls.certresolver=le
      - traefik.docker.network=web
    networks:
      - web

networks:
  web:
    external: true

Once everything is up and running, you can verify container logs or query a test request like:

curl --data "language=en-US&text=a simple test" https://languagetool.example.com/v2/check

Using your own languagetool server

LanguageTool is well-integrated within popular browsers and various tools. When editing markdown files, I mainly use it within my primary browser Google Chrome and within my source-code editor vscode.

Browser-Plugin

When using the LanguageTool browser-plugin, you need to navigate to the options-menue and setup your own LanguageTool server like this:

Visual Studio Code Extension

If you want language-tool support for your markdown files within vscode you can use the LTEX Extension.

It will provide issue highlighting, supports comment checking for many programming languages (opt-in) and you can use the replacement suggestions via the quick-fixes dialog, which looks like the following:

To use your own LanguageTool server, you have to configure the root url within the ltex.languageToolHttpServerUrisetting:

DEV Community: dacbreakpoint