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

Refactor all compilers to work on a DocumentationSet #3492

Merged
merged 3 commits into from Mar 24, 2023

Conversation

mvriel
Copy link
Member

@mvriel mvriel commented Mar 23, 2023

Since the compilers work on files and indexes on a DocumentationSet, the entirety of them should really interact with a DocumentationSet and not a project

Since the compilers work on files and indexes on a DocumentationSet, the
entirety of them should really interact with a DocumentationSet and not
a project
Copy link
Member

@jaapio jaapio left a comment

Choose a reason for hiding this comment

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

I'm missing some checks on ApiSetDescriptor in some of the compiler passes. Did I overlook something?

{
$this->analyzer->analyze($project);
$this->analyzer->analyze($documentationSet);
Copy link
Member

Choose a reason for hiding this comment

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

This should only run on apiSet?

Copy link
Member Author

Choose a reason for hiding this comment

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

The analyzer itself does varying things depending on the type of documentation set

@mvriel
Copy link
Member Author

mvriel commented Mar 24, 2023

I'm missing some checks on ApiSetDescriptor in some of the compiler passes. Did I overlook something?

I have explicitly not added these and tried to keep it as generic as possible. At the moment, guides do not use files and indexes; but I would love to have this a generic mechanism across all Documentation Sets.

At this point, because only API Sets populate these indexes, I have limited the checks on API Sets only where it really is about API Sets. You can find a few of these in the compiler passes themselves

When building documentation, the elements offset is required and as such
I have moved the initialization to the front of the compiler.

A question could be whether this is really needed, but I have postponed
that question for later; so that the effort to support Documentation
Sets progresses.
@jaapio jaapio merged commit 49e48dc into master Mar 24, 2023
57 checks passed
@jaapio jaapio deleted the compile-per-documentation-set branch March 24, 2023 14:06
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.

None yet

2 participants