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.

Sign up for GitHub

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

Jump to bottom

Switch from Orchid to XXX #166

Open
serpro69 opened this issue Oct 30, 2022 · 0 comments
Open

Switch from Orchid to XXX #166

serpro69 opened this issue Oct 30, 2022 · 0 comments
Labels
docs 📃 Documentation-related issues

Comments

@serpro69
Copy link
Owner

serpro69 commented Oct 30, 2022 •
edited
Loading

Orchid was fun to work with, but even though it works fine for the most part, it has been unmaintained for quite awhile (last commit on 2021-08-08).

The bigger problem is that it was using jcenter to host artifacts and never moved to maven central or any other repo (see orchidhq/Orchid#393 ), hence a move to another documentation framework is more of a "must" than a "should".

A few options to consider:

  • hugo
  • mkdocs
  • docusaurus
@serpro69 serpro69 added the docs 📃 Documentation-related issues label Oct 30, 2022
serpro69 added a commit that referenced this issue Aug 13, 2024
@serpro69
Make 'docs' a standalone module
0aa616f 
Docs are finally starting to fail hard...

Version 0.21.1 of Orchid seems to no longer be available:

 Could not resolve all dependencies for configuration ':docs:detachedConfiguration3'.
   > Could not find io.github.javaeden.orchid:OrchidCore:0.21.1.
     Searched in the following locations:
       - https://repo.maven.apache.org/maven2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
       - https://plugins.gradle.org/m2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
     Required by:
         project :docs

I've discovered that there's a version 1.0.0-SNAPSHOT published to maven
central, and tried using that, but it also fails:

[INFO] GeneratorServiceImpl:     Generating [indices]
Error: Exception in thread "main" java.lang.NoSuchMethodError: 'double kotlin.time.DurationKt.toDuration(long, java.util.concurrent.TimeUnit)'
	at com.eden.orchid.api.generators.GeneratorMetrics.getIndexingTime-UwyO8pc$orchid_core(GeneratorMetrics.kt:28)

This seems to be due to breaking changes in kotlin, since
orchid:1.0.0-SNAPSHOT uses 1.4.31 and we're using 1.9.x in kotlin-faker currently.

So the only option I could see before #166 is done (which I still can't
find time for...), taking docs out of the kotlin-faker build
configuration and converting it to a standalone gradle project, with own
build configs, a lower gradle and kotlin version (due to
kotlin-to-gradle compatibilities), and so on, seems like the only viable
option.

The good part of this whole mess is that this workaround
actually seems to be working... phew.
serpro69 added a commit that referenced this issue Aug 13, 2024
@serpro69
Make 'docs' a standalone module
f28c54c 
Docs are finally starting to fail hard...

Version 0.21.1 of Orchid seems to no longer be available:

 Could not resolve all dependencies for configuration ':docs:detachedConfiguration3'.
   > Could not find io.github.javaeden.orchid:OrchidCore:0.21.1.
     Searched in the following locations:
       - https://repo.maven.apache.org/maven2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
       - https://plugins.gradle.org/m2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
     Required by:
         project :docs

I've discovered that there's a version 1.0.0-SNAPSHOT published to maven
central, and tried using that, but it also fails:

[INFO] GeneratorServiceImpl:     Generating [indices]
Error: Exception in thread "main" java.lang.NoSuchMethodError: 'double kotlin.time.DurationKt.toDuration(long, java.util.concurrent.TimeUnit)'
	at com.eden.orchid.api.generators.GeneratorMetrics.getIndexingTime-UwyO8pc$orchid_core(GeneratorMetrics.kt:28)

This seems to be due to breaking changes in kotlin, since
orchid:1.0.0-SNAPSHOT uses 1.4.31 and we're using 1.9.x in kotlin-faker currently.

So the only option I could see before #166 is done (which I still can't
find time for...), taking docs out of the kotlin-faker build
configuration and converting it to a standalone gradle project, with own
build configs, a lower gradle and kotlin version (due to
kotlin-to-gradle compatibilities), and so on, seems like the only viable
option.

The good part of this whole mess is that this workaround
actually seems to be working... phew.
serpro69 added a commit that referenced this issue Aug 13, 2024
@serpro69
Make 'docs' a standalone module
f62d63b 
Docs are finally starting to fail hard...

Version 0.21.1 of Orchid seems to no longer be available:

 Could not resolve all dependencies for configuration ':docs:detachedConfiguration3'.
   > Could not find io.github.javaeden.orchid:OrchidCore:0.21.1.
     Searched in the following locations:
       - https://repo.maven.apache.org/maven2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
       - https://plugins.gradle.org/m2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
     Required by:
         project :docs

I've discovered that there's a version 1.0.0-SNAPSHOT published to maven
central, and tried using that, but it also fails:

[INFO] GeneratorServiceImpl:     Generating [indices]
Error: Exception in thread "main" java.lang.NoSuchMethodError: 'double kotlin.time.DurationKt.toDuration(long, java.util.concurrent.TimeUnit)'
	at com.eden.orchid.api.generators.GeneratorMetrics.getIndexingTime-UwyO8pc$orchid_core(GeneratorMetrics.kt:28)

This seems to be due to breaking changes in kotlin, since
orchid:1.0.0-SNAPSHOT uses 1.4.31 and we're using 1.9.x in kotlin-faker currently.

So the only option I could see before #166 is done (which I still can't
find time for...), taking docs out of the kotlin-faker build
configuration and converting it to a standalone gradle project, with own
build configs, a lower gradle and kotlin version (due to
kotlin-to-gradle compatibilities), and so on, seems like the only viable
option.

The good part of this whole mess is that this workaround
actually seems to be working... phew.
serpro69 added a commit that referenced this issue Aug 14, 2024
@serpro69
Make 'docs' a standalone module
4f2ae80 
Docs are finally starting to fail hard...

Version 0.21.1 of Orchid seems to no longer be available:

 Could not resolve all dependencies for configuration ':docs:detachedConfiguration3'.
   > Could not find io.github.javaeden.orchid:OrchidCore:0.21.1.
     Searched in the following locations:
       - https://repo.maven.apache.org/maven2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
       - https://plugins.gradle.org/m2/io/github/javaeden/orchid/OrchidCore/0.21.1/OrchidCore-0.21.1.pom
     Required by:
         project :docs

I've discovered that there's a version 1.0.0-SNAPSHOT published to maven
central, and tried using that, but it also fails:

[INFO] GeneratorServiceImpl:     Generating [indices]
Error: Exception in thread "main" java.lang.NoSuchMethodError: 'double kotlin.time.DurationKt.toDuration(long, java.util.concurrent.TimeUnit)'
	at com.eden.orchid.api.generators.GeneratorMetrics.getIndexingTime-UwyO8pc$orchid_core(GeneratorMetrics.kt:28)

This seems to be due to breaking changes in kotlin, since
orchid:1.0.0-SNAPSHOT uses 1.4.31 and we're using 1.9.x in kotlin-faker currently.

So the only option I could see before #166 is done (which I still can't
find time for...), taking docs out of the kotlin-faker build
configuration and converting it to a standalone gradle project, with own
build configs, a lower gradle and kotlin version (due to
kotlin-to-gradle compatibilities), and so on, seems like the only viable
option.

The good part of this whole mess is that this workaround
actually seems to be working... phew.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
docs 📃 Documentation-related issues
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
1 participant
@serpro69