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
Fix all docs type class and data types links #1120
Comments
I have been reviewing the issue and wanted to ask a coupe of questions to make sure I got everything right:
|
|
By redirects I mean that we may loose traffic and position reworking the links so it'd be nice if the existing ones would redirect to the new links based on the package.seems like @Tylos has a plan for this though. |
Currently working on a forked version of arrow You can access the documentation using the new url Whereas There are some issues I will keep investigating. When the user clicks on the lateral menu for sections which perform a redirect, the menu state is lost |
@Tylos regarding the menu state, that behaviour you are seeing is because it is set at runtime by comparing through JS the current URL with the one considered for the menu entry, which is set through Liquid for each entry in the sidebar:
Changing the URL in the menu entry might suffice, but I guess that if the URLs could be changing depending on the source code organization, this has to be considered and updated when that happens. |
Uh, it'd be great if the menu scrolled to the open position afterwards. It's something that's bugging me for a while :) |
@calvellido changing the URLs in menu.yml gets it back to work again as you said! Do you think I should swap other internal usages of old link to the new one? |
Have completed changing the URL from all the classes in However, there are some cases the links are still broken:
Should I open a PR with these changes or should I address some other changes before @raulraja @calvellido? You can check the changes here |
Nice @Tylos! We are about to hopefully stabilize the CI process, I think after that your PR will come in handy 👍 |
Have you been able to include some link checker into the mix? That would be awesome! |
How's this going? Is there an scenario where we could merge this or we need to wait for something? |
@calvellido just fixed the site in case that was a hold up to get this merged in master |
Is that fixing the 404 thing? Besides that: what about the module migration required (as for Optics) mentioned by @Tylos? |
So the current docs have now the API docs. It'd be better if we work on moving the docs in the current type classes and data types to the kdocs and we make the API docs kdoc generated URL the main one in the menu. We need to push forward documenting kdoc first and leave web docs only for tutorials. I'll be happy to jump on a call if needed to explain more details |
Sorry, is that directly related to this? Ideally we'd move that discussion to a separate issue to work on it and we'd try to unlock this. What's exactly pending here @Tylos? |
All the type classes and data types that are in the docs modules are migrated Wich was the goal of the issue. Would need to update the contribute.md as I had to add a Gemfile. Apart from that should be ready to review Was waiting for CI to be stable as @calvellido mentioned, and resolve if other packages would be required to change. If you prefer it can be moved to another issue |
Yes it is directly related. The Pages where the work of this ticket is going to get done they will disappear. For example the Option data type will point in the menu here https://arrow-kt.io/docs/apidocs/arrow-core/arrow.core/-option/index.html which is driven by kdoc. So there is a work of porting non tutorial related docs to the kdocs |
@Tylos in that case if the work is done it has to be merged now before we start with the migration to get all kdocs properly documented with examples per function. |
Sounds good. Let's try to move on this tomorrow or when you have a moment then @Tylos. Let me know if you need any help for unlocking pls. Sorry for being a bit too spammy at this time. |
Will do tomorrow first thing in the morning |
There was some gems/jekyll misbehaving but everything is now working, and already merged. If everything goes well on the CI side (it should) you can expect the changes to go live in about ~20 minutes. Thanks for the hard work @Tylos! |
🤞 hope everything goes well! Kudos to @pedrovgs who helped me out with jekyl 💋 |
All type classes and data type in the documentation site should follow the same path as the package they declared in terms of permalinks in the docs.
For example:
arrow.core.Option
->docs/arrow/core/option
All permalinks need to be modified and if possible preserve existing redirects.
This is necessary because we plan on using reflection and other introspection techniques to have some parts of the docs autogenerated at build time. Links for a given data type or type class need to be predictable so the generator can assume those paths to be there.
The text was updated successfully, but these errors were encountered: