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

Readme: Be specific about requiring Hugo 0.113.0 to build the spec #1587

Closed
wants to merge 4 commits into from

Conversation

akirk
Copy link

@akirk akirk commented Jun 27, 2023

The GHA workflow is pinned at 0.93.3 and the spec won't build in recent versions of Hugo, see #1586.

Until that error is resolved in modern versions, the building instructions should guide contributors to be able to build a working version and not run into errors when trying to build it.

While building the spec in more modern hugo versions than 0.93.3 is possibe (I successfully tested with 0.113, see #1586), the build process with that version is proven through the Github Actions and thus reflects the currently safest path to get the spec built locally (without using docker). There is at least one known issue with newer versions (#1544).

Signed-off-by: Alex Kirk <[email protected]>

Preview: https://pr1587--matrix-spec-previews.netlify.app

@akirk akirk requested a review from a team as a code owner June 27, 2023 02:37
@jaller94
Copy link
Contributor

jaller94 commented Jun 27, 2023

Yes, please add this note.
I've failed way too long to fix the build with the most recent Hugo release before finding the issue #1586.

I'm maintaining the Matrix spec for the Dash offline documentation viewer:
Kapeli/Dash-User-Contributions#4360

Copy link
Member

@richvdh richvdh 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 the contribution!

However, #1544 is now fixed and I don't think we should be pinning ourselves to such an old version. Indeed, #1591 updates the version used in the GHA config.

README.md Outdated Show resolved Hide resolved
@akirk akirk changed the title Readme: Be specific about requiring Hugo 0.93.3 to build the spec Readme: Be specific about requiring Hugo 0.113.0 to build the spec Jun 28, 2023
@richvdh richvdh self-requested a review June 28, 2023 08:55
Copy link
Member

@richvdh richvdh left a comment

Choose a reason for hiding this comment

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

Now that #1586 is fixed, I'm not convinced we need any changes here. WDYT?

@akirk
Copy link
Author

akirk commented Jul 4, 2023

I am afk but if it's fixed I'm ok to just close this one.

@richvdh
Copy link
Member

richvdh commented Jul 4, 2023

Thanks for the contribution anyway!

@richvdh richvdh closed this Jul 4, 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