-
Notifications
You must be signed in to change notification settings - Fork 8
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
Migrate away from GitBook #48
Comments
What are ALICE using? |
A modified version of our repository, see here. |
I'm probably blind; where do they test their code snippets? |
IIRC they parse the sources using |
MkDocs is visually clean and similar to GitBook, haven't really tested it out yet though. I'm still on the lookout for a Hugo solution; I've seen a few worth testing, and Hugo technically could support the multiple output formats, etc, but haven't found a solution that provides it yet. |
At some point we should consider moving from GitBook to something else as the CLI interface we use is no longer maintained and contains various bugs. We could consider moving to CERN GitLab, but this would only apply to the LHCb repositories and we might not want to maintain multiple CI pipelines. I think the preference is to use a "popular" static site generator in the hope that we avoid being stuck with an abandonded tool.
Essential features:
Potentially desirable features:
The text was updated successfully, but these errors were encountered: