How to Improve the Help Page
Was this helpful?
Was this helpful?
Here is a quick start guide on how to improve help pages in the .
The Jabref help pages are hosted at with integration to GitHub, which provides version control based on . In order to edit or create a JabRef help page, you need a GitHub account. You can sign up for free. If you already have an account, please make sure that you are signed in.
The easiest way to fix small errors, or to add additional information, is to edit a help page directly in your browser, using the following steps.
At the top of each help page, you can find the GitHub icon with "Edit on GitHub" link. Just click the link to show the source of the page.
This leads you to the GitHub page associated with the help page:
To actually edit the page, click on the pencil icon, as highlighted above.
The window to edit the page at GitHub looks like this:
In order to review your changes, click on the "Preview changes" tab:
To save the changes, create a so-called "Commit" by scrolling down and pressing the "Propose File Change" button:
Please note: The message you provide here will be visible in the history of the help page, so please consider your change and provide a meaningful description of your changes.
As the last step, submit the changes you have made back to the JabRef team:
Just press the "Create Pull Request" button, and confirm the creation of the request on the next page.
To edit more than one file at a time, add screenshots, and for other more advanced changes, we recommend that you checkout this repository locally and create a Pull Request of your changes using the standard git and GitHub workflow.
Most text can be simply added/edited in this field as plain text. However, you can style your contribution by using . Markdown is a rather easy way to format text without the need for complex markup, such as with HTML. You can find an introduction to markdown or .
That's it! The JabRef team will review your changes and publish them on .
The best way to enter tables is to use this for Markdown. It has the nice feature to generate markdown tables from different sources, e.g. you can directly copy the table from a spreadsheet or upload a csv file. Just copy and paste the generated markdown into the documentation.
