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

mkdocs: Fix file not found warnings #926

Closed

Conversation

bact
Copy link
Collaborator

@bact bact commented Apr 21, 2024

Fix file not found issues in spec doc generation.

Currently, mkdocs serve and mkdocs build emit these warnings:

WARNING -  A reference to 'model/Software/Properties/isDirectory.md' is included in the 'nav' configuration, which is not
           found in the documentation files.
WARNING -  A reference to 'model/Dataset/Classes/Dataset.md' is included in the 'nav' configuration, which is not found
           in the documentation files.
WARNING -  A reference to 'model/Dataset/Properties/sensitivePersonalInformation.md' is included in the 'nav'
           configuration, which is not found in the documentation files.
WARNING -  A reference to 'model/AI/Properties/sensitivePersonalInformation.md' is included in the 'nav' configuration,
           which is not found in the documentation files.
WARNING -  Doc file 'conformance.md' contains a link 'diffs-from-previous-editions.md', but the target is not found among
           documentation files.
WARNING -  Doc file 'conformance.md' contains a link 'SPDX-Lite.md', but the target is not found among documentation
           files.

The first 4 warnings are responsible to the four erroneous None class/properties displaying in the left pane of https://spdx.github.io/spdx-spec/v3.0/ . They are all old property names. New property names are already included in the nav. Fixed by removing all 4 outdated references:

The remaining 2 warnings are fixed by add directory name to the targets:

  • diffs-from-previous-editions.md and SPDX-Lite.md are in annexes/ directory

@bact bact changed the title Fix file not found warnings mkdocs: Fix file not found warnings Apr 21, 2024
Copy link
Member

@goneall goneall left a comment

Choose a reason for hiding this comment

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

LGTM - Thanks @bact

bact and others added 4 commits April 22, 2024 22:18
Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
We switched over to using the GitHub release notes on version 2.3 and later.

This adds references to the GitHub release notes in the CHANGELOG.md

Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
The check assumes that JSON example snippets are all parts of a single
JSON document that needs validating, but not all files are written
that way.  To avoid errors that have nothing to do with the
correctness of the examples, we should only check files which meet the
check's assumptions.

Fixes spdx#912.

Signed-off-by: Jeff Licquia <jeff@licquia.org>
Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
@bact bact force-pushed the fix-file-not-found-warnings branch from 851b96b to a57c094 Compare April 23, 2024 05:19
@goneall goneall added this to the 3.0.1 milestone Apr 30, 2024
Copy link
Contributor

@kestewart kestewart left a comment

Choose a reason for hiding this comment

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

Thanks for tracking this down and explaining. LGTM.

@goneall
Copy link
Member

goneall commented May 3, 2024

@bact - can you resolve the merge conflicts - thanks

I cannot see any changes from the last commit but GitHub still say that there're conflicts. So trying to change minor things. (note the newline break between lines 7 and 8)
Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
bact added a commit to bact/spdx-spec that referenced this pull request May 3, 2024
A rework of spdx#926 to fix unresolvable merge conflicts

Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
@bact
Copy link
Collaborator Author

bact commented May 3, 2024

@goneall @kestewart I have tried to resolve the merge conflicts but I cannot see any changes from the development/v3.0.1 branch that will cause the conflict. The bact:fix-file-not-found-warnings branch is basically ahead of the development/v3.0.1 branch without any behind commits.

I opened a new PR #955 and copied the changes from this PR over. If you can re-review in that PR. I can close this PR if agreed. Sorry for inconvenience.

Copy link
Member

@goneall goneall left a comment

Choose a reason for hiding this comment

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

LGTM

@bact bact closed this May 4, 2024
goneall pushed a commit that referenced this pull request May 5, 2024
A rework of #926 to fix unresolvable merge conflicts

Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
@bact
Copy link
Collaborator Author

bact commented May 8, 2024

Close - merged in #955

@bact bact deleted the fix-file-not-found-warnings branch May 8, 2024 05:46
bact added a commit to bact/spdx-spec that referenced this pull request Jun 10, 2024
A rework of spdx#926 to fix unresolvable merge conflicts

Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
vargenau pushed a commit to vargenau/spdx-spec that referenced this pull request Jul 18, 2024
A rework of spdx#926 to fix unresolvable merge conflicts

Signed-off-by: Arthit Suriyawongkul <arthit@gmail.com>
Signed-off-by: Marc-Etienne Vargenau <marc-etienne.vargenau@nokia.com>
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