1
0
mirror of https://github.com/chylex/IntelliJ-IdeaVim.git synced 2025-05-02 10:34:04 +02:00

Move contribution information to separate file

This commit is contained in:
Alex Plate 2019-02-21 19:32:56 +03:00
parent 434c1ef275
commit 48bef164ef
No known key found for this signature in database
GPG Key ID: 0B97153C8FFEC09F
2 changed files with 51 additions and 49 deletions

45
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,45 @@
### Where to Start
In order to contribute to IdeaVim you should have some understanding of Java or [Kotlin](https://kotlinlang.org/).
See also these docs on the IntelliJ API:
* [IntelliJ architectural overview](http://confluence.jetbrains.com/display/IDEADEV/IntelliJ+IDEA+Architectural+Overview)
* [IntelliJ plugin development resources](http://confluence.jetbrains.com/display/IDEADEV/PluginDevelopment)
You can start by picking relatively simple tasks that are tagged with
[#patch_welcome](https://youtrack.jetbrains.com/issues/VIM?q=%23patch_welcome%20%23Unresolved%20sort%20by:%20votes%20)
in the issue tracker.
### Development Environment
1. Fork IdeaVim on GitHub and clone the repository on your local machine.
2. Import the project from existing sources in IntelliJ IDEA 2018.1 or newer (Community or
Ultimate) using "File | New | Project from Existing Sources..." or "Import
Project" from the start window.
* In the project wizard select "Import project from external model | Gradle"
* Select your Java 8+ JDK as the Gradle JVM, leave other parameters unchanged
3. Run your IdeaVim plugin within IntelliJ via a Gradle task
* Select "View | Tool Windows | Gradle" tool window
* Launch "ideavim | intellij | runIde" from the tool window
4. Run IdeaVim tests via a Gradle task
* Select "View | Tool Windows | Gradle" tool window
* Launch "ideavim | verification | test" from the tool window
5. Build the plugin distribution by running `./gradlew clean buildPlugin` in the
terminal in your project root.
* The resulting distribution file is build/distributions/IdeaVim-VERSION.zip
* You can install this file using "Settings | Plugins | Install plugin
from disk"

View File

@ -56,9 +56,11 @@ Get an Early Access
-------------------
Would you like to try new features and fixes? Join the Early Access Program and
receive EAP builds as updates! Add this URL to "Settings | Plugins |
Browse Repositories | Manage Repositories":
[https://plugins.jetbrains.com/plugins/eap/ideavim](https://plugins.jetbrains.com/plugins/eap/ideavim)
receive EAP builds as updates!
Add [https://plugins.jetbrains.com/plugins/eap/ideavim](https://plugins.jetbrains.com/plugins/eap/ideavim) to:
_IJ versions 2018.3 and newer:_ "Settings | Plugins | Cog icon | Manage Plugin Repositories"
_IJ versions 2018.2 and older:_ "Settings | Plugins | Browse Repositories | Manage Repositories"
See [the changelog](CHANGES.md) for the list of hot unreleased features.
@ -182,52 +184,7 @@ For example, here `\r` is mapped to the Reformat Code action:
Contributing
------------
### Where to Start
In order to contribute to IdeaVim you should have some understanding of Java.
See also these docs on the IntelliJ API:
* [IntelliJ architectural overview](http://confluence.jetbrains.com/display/IDEADEV/IntelliJ+IDEA+Architectural+Overview)
* [IntelliJ plugin development resources](http://confluence.jetbrains.com/display/IDEADEV/PluginDevelopment)
You can start by picking relatively simple tasks that are tagged with
[#patch_welcome](http://youtrack.jetbrains.com/issues/VIM?q=%23patch_welcome)
in the issue tracker.
### Development Environment
1. Fork IdeaVim on GitHub and clone the repository on your local machine.
2. Import the project from existing sources in IntelliJ IDEA 2018.1 or newer (Community or
Ultimate) using "File | New | Project from Existing Sources..." or "Import
Project" from the start window.
* In the project wizard select "Import project from external model | Gradle"
* Select your Java 8+ JDK as the Gradle JVM, leave other parameters unchanged
3. Run your IdeaVim plugin within IntelliJ via a Gradle task
* Select "View | Tool Windows | Gradle" tool window
* Launch "ideavim | intellij | runIde" from the tool window
4. Run IdeaVim tests via a Gradle task
* Select "View | Tool Windows | Gradle" tool window
* Launch "ideavim | verification | test" from the tool window
5. Build the plugin distribution by running `./gradlew clean buildPlugin` in the
terminal in your project root.
* The resulting distribution file is build/distributions/IdeaVim-VERSION.zip
* You can install this file using "Settings | Plugins | Install plugin
from disk"
See [CONTRIBUTING.md](CONTRIBUTING.md)
Authors
-------