jargonsdev / jargonsdev/roadmap

IDEs Plugins

Open
#4 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
No language data
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

- Implementation PR:

# Summary
Develop plugins for popular Integrated Development Environments (IDEs), such as VS Code and IntelliJ, to integrate jargons.dev directly into developers' workflows. These plugins will allow users to quickly view definitions of terms from jargons.dev when they hover over the terms in comments or documentation within their code.

# Motivation
Developers spend a significant amount of time in their IDEs, making these environments a natural and effective place to integrate/use jargons.dev. With this feature, users can access the dictionary without leaving their coding environment, reducing context-switching and enhancing productivity. This integration could make jargons.dev a must-have tool for developers, fostering familiarity and frequent use.

# Goal
1. **Plugin Features**:
- Enable hover functionality to display definitions of terms sourced from jargons.dev.
- Support configuration options for developers to enable or disable the feature in specific file types.
- Provide an easy way to access the full definition or related resources via a link to the jargons.dev website.

2. **Initial IDE Targets**:
- Focus on plugins for **VS Code** and **IntelliJ IDEA** as the first IDEs due to their widespread use among developers.
- Design the plugin architecture to be easily extendable to other IDEs in the future.

3. **Backend Changes**:
- Implement an API endpoint in jargons.dev to fetch term definitions efficiently for IDE integration.
- Ensure the API is optimized for quick responses to provide a smooth user experience.

4. **User Experience Consideration**:
- Create intuitive UX/UI for the hover card, ensuring readability and alignment with the respective IDE's style.
- Ensure the plugin does not disrupt the coding experience and is performant in large files.

5. **Adoption**:
- Publish the plugins in the VS Code Marketplace and JetBrains Plugin Repository.
- Provide clear documentation for installation and use.

Contributor guide

No contributing guide indexed for this repository

Research direction

The proposal covers VS Code and IntelliJ IDEA plugins, a definition-fetching API endpoint, marketplace publication, and installation documentation, but names no files or tests. Start by breaking the proposal into separately scoped plugin, API, UX, publication, and documentation work; done would require the listed hover, configuration, linking, performance, publishing, and documentation goals.

Written by the indexing model from the issue text.

Assessment

Tech stack
vscode
Domain
api, developer-experience, devtools, documentation
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.