Skip to content

Latest commit

 

History

History
58 lines (33 loc) · 2.64 KB

CONTRIBUTING.md

File metadata and controls

58 lines (33 loc) · 2.64 KB

Contributing to the JabRef Help

You want to contribute to help.jabref.org? Great!

Here is a quick start guide:

Prerequisite

Our help pages are hosted at GitHub which provides version control based on git. In order to edit or create a JabRef help page you need a GitHub account. You can sign up here for free.

If you already have an account, please make sure that you are signed in.

Editing Help Pages directly in the browser

The easiest way to fix small errors or to add additional information is to edit a JabRef help page directly in your browser:

Start editing

At the bottom of each help page you can find a link "Edit Page":

Click on Edit Page

Just click here to show the source of the page.

This leads you to GitHub:

Click on the pencil icon

To actually edit the page click on the pencil icon which is highlighted above.

Make your changes

The window to edit the page at GitHub looks like this:

Edit view at GitHub

Most text can be simply added in this field as plain text. However, you can style your contribution by using markdown. Markdown is a rather easy way to format text without the need for complex markup as for example in HTML.

You can find an introduction to markdown here or here.

In order to check your changes hit the "Preview Changes" tab:

Edit view at GitHub

Saving the changes

To save the changes you have to create a so called "Commit" by scrolling down and hitting the button "Propose File Change":

Save changes

Please note: The message you provide here will be visible in the history of the help page, so please think a second to provide a meaningful description of your changes.

As a last step you have to submit the changes you have made back to us:

Create Pull Request

Just hit the button "Create Pull Request" and confirm the creation on the next page which is opened by hitting "Create Pull Request".

That's it! We'll review your changes and publish them at help.jabref.org.

Advanced editing

To edit more than one file at a time, to add screenshots and for other more advanced changes we recommend to checkout this repository locally and to create a PR of your changes using the standard git and GitHub workflow.