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

Reorganize TermVectorsFormat format description (javadocs). #130

Merged

Conversation

mocobeta
Copy link
Contributor

@mocobeta mocobeta commented May 7, 2021

(Maybe) trivial documentation change. Current format description of TermVectorsFormat is a little bit hard to understand because various information (datatypes and explanation) is mixed up in the same line.
It could be improved if it is reorganized in a similar way to PostingsFormat; the datatypes and additional information are strictly separated there.

Screenshot of the reorganized javadoc with this pr:
termvectorsformat_refined_javadoc

Some type information was added when possible. No information was removed.

@mocobeta
Copy link
Contributor Author

mocobeta commented May 7, 2021

I think few people care about the format documentation, but at least it will not hurt anything (...and might be helpful for advanced users).
I'll keep open it for a while for feedback, if there is anyone interested in.

@mocobeta mocobeta merged commit 6ebf959 into apache:main May 8, 2021
@mocobeta mocobeta deleted the refine-termvectors-format-description branch May 8, 2021 23:45
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.

1 participant