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

Facets XML (#311) #312

Merged
merged 3 commits into from
Jun 20, 2023
Merged

Facets XML (#311) #312

merged 3 commits into from
Jun 20, 2023

Conversation

nikcio
Copy link
Contributor

@nikcio nikcio commented Nov 17, 2022

This adds XML documentation to the facets feature as well as other places in the project. This means that this PR is a super set of #311 and should be merged after the facets feature.

To see the changes in this PR before merging #311 see this commit

What changed

  • Added <GenerateDocumentationFile>True</GenerateDocumentationFile> to project files
  • Fixed XML warnings
  • Added XML to new facets feature.

Approach

  • The XML information has been added with the information that could be interpreted by looking in the source code and documentation.
  • Added <inheritdoc /> to constructors without XML information. Constructor XML information is rarely needed so adding <inheritdoc /> removes the XML warning.

Remaining XML warnings

Some classes have not had XML added due to not knowing what the class / method is used to do.

  • GenericDirectoryFactory
  • FileSystemDirectoryFactory
  • IApplicationIdentifier
  • IApplicationIdentifier.GetApplicationUniqueIdentifier()
  • IApplicationRoot
  • IApplicationRoot.ApplicationRoot

This was referenced Nov 17, 2022
@nikcio nikcio marked this pull request as ready for review November 18, 2022 14:35
@nzdev
Copy link
Contributor

nzdev commented Dec 12, 2022

#322 Should help with showing all the api xml documentation added in this pr on the docs site.

@nikcio nikcio force-pushed the chore/facets-xml branch 3 times, most recently from 22222ab to 8bdbed5 Compare December 16, 2022 07:27
@nikcio nikcio changed the base branch from release/3.0 to release/4.0 June 18, 2023 11:51
@nikcio nikcio force-pushed the chore/facets-xml branch from 8bdbed5 to 1cb285e Compare June 18, 2023 11:59
@nikcio
Copy link
Contributor Author

nikcio commented Jun 18, 2023

@Shazwazza I've updated this PR so it's now again ready to be merged. I also fixed 2 things that were missed in #311 :

  • LuceneFacetExtractionContext now has a namespace
  • IFacetResult now has the TryGetFacet method.

Copy link
Owner

@Shazwazza Shazwazza left a comment

Choose a reason for hiding this comment

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

Amazing!

src/Examine.Lucene/ReaderStatus.cs Show resolved Hide resolved
@Shazwazza Shazwazza merged commit 78de273 into Shazwazza:release/4.0 Jun 20, 2023
@nikcio nikcio mentioned this pull request Jun 22, 2023
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.

3 participants