Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation for the GUI for consistency check #551

Merged
merged 11 commits into from
Mar 11, 2025

Conversation

priyanshu16095
Copy link
Contributor

This PR adds documentation for GUI for consistency check.

@priyanshu16095 priyanshu16095 marked this pull request as ready for review February 22, 2025 20:16
@koppor
Copy link
Member

koppor commented Mar 6, 2025

We first need to get JabRef/blog.jabref.org#109 done. Then we can port text from the blog post here.

@koppor koppor marked this pull request as draft March 6, 2025 14:32
@priyanshu16095
Copy link
Contributor Author

I have updated the documentation, took the content from the blog post. Also, added a screenshot of two sample entries.

@priyanshu16095 priyanshu16095 marked this pull request as ready for review March 10, 2025 22:50
Copy link
Member

@koppor koppor left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please also add https://blog.jabref.org/2025/03/08/Consistency-Check/#why-it-matters as section "Motivation" or "Background"

Comment on lines 47 to 51
- **EntryType Headings**: The first column lists the name of the selected entry type.
- **Choose Entry type**: Entry types (such as article, book, in-proceedings, etc.) will be listed in a dropdown menu.
- **Column 2**: Citation key of the entry.
- **Other columns**: Represent the fields and their status (`x`, `o`, `?`, or `-`).
- **Navigation**: Clicking on a line in the table will take you directly to the corresponding entry in the editor, making it easy to address inconsistencies.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Indent does not match content.

Maybe, you can describe the columns as bullet list - and the other points as another list?

Currently, first bullet point: heading. second bullet point: something else; sub bullets of second bullet point: headings.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done, but should this also be done for the blog post?

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would be nice for the blog post, too.

@koppor koppor merged commit 89a0d53 into JabRef:main Mar 11, 2025
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants