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

Versioning takes up exponential space #1940

Closed
rnett opened this issue May 27, 2021 · 3 comments · Fixed by #1963
Closed

Versioning takes up exponential space #1940

rnett opened this issue May 27, 2021 · 3 comments · Fixed by #1963
Labels

Comments

@rnett
Copy link
Contributor

rnett commented May 27, 2021

Describe the bug
If you naively use multi-version documentation, it quickly takes up extremely large amounts of space. If you generate multi-version docs, then save those docs for use in future versions, each version contains all version before it, recursively. I.e.

0.2.12
   0.2.11
      0.2.10
         ...
      0.2.9
         ...
      0.2.8
         ...
       ...
   0.2.10
      0.2.9
         ...
      0.2.8
         ...
       ...
   0.2.9
      0.2.8
         ...
       ...
   0.2.8
         ...
       ...

I suspect you could work around this by generating the "saved" docs without any past versions (and only using them for the current version), but I have yet to have time to test this.

@rnett rnett added the bug label May 27, 2021
@rnett
Copy link
Contributor Author

rnett commented May 27, 2021

A big part of the problem is that if you have an older version with the same version number as the current version, it is still included in the stored older versions. If you update docs multiple times per version (like say with snapshots) this eats a lot of space, and there's no reason to do it since it's not selectable anyways.

@MarcinAman
Copy link
Contributor

Uh, thats unfortunate. I guess a work-around for now is to write a small gradle script that would delete previous, nested versions before generating an output for the newest one

@rnett
Copy link
Contributor Author

rnett commented May 27, 2021

Yeah, that's working fine for me at the moment (although I'm doing it in CI).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants