Skip to content

Conversation

mmattel
Copy link
Collaborator

@mmattel mmattel commented Oct 13, 2025

References: owncloud/docs#5046 (Remove overlay files (migrate to docs-ui) )

This PR is two fold:

  • It adds all static files formerly in the docs repo to this repo where they belong.
    This makes these files available to all builds as they are part of the bundle zip file now.
  • It updates the build task to manage static files correctly.

It is VERY important that this PR is merged FIRST than the docs PR. The latter removes the "supplemental" definition from the docs playbook (site.yml) and its related files.

Things stay the same contentwise, it is just relocating files and functionality.

Tested via a local build using the docs branch that removes the supplemental definition - works.

@mmattel mmattel force-pushed the migrate_supplemental_from_docs_here branch from 501d665 to 70c6252 Compare October 13, 2025 16:32
if (!fs.existsSync(dest)) {
mkdirp.sync(dest)
}
if (!fs.existsSync(`${src}/static`)) {
Copy link
Collaborator

@LukasHirt LukasHirt Oct 13, 2025

Choose a reason for hiding this comment

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

I would say this one shouldn't be created in the build process.

  1. if the directory is missing, it might symbolise something broken so actually failing the process because of that would make sense
  2. providing source directories feels more like maintainers responsibility than the build script itself

The dest directory is handled before that as that is the specific output of the build script so in that case I would say it's correct to force the script to take care of that.

Copy link
Collaborator Author

@mmattel mmattel Oct 13, 2025

Choose a reason for hiding this comment

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

No, the proposed code change is correct, the static folder is OPTIONAL (no kidding). I will explain this tomorrow in zoom 😃

@mmattel mmattel merged commit 216fd4c into master Oct 14, 2025
1 check passed
@mmattel mmattel deleted the migrate_supplemental_from_docs_here branch October 14, 2025 07:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants