barbajs / barba

Create badass, fluid and smooth transitions between your website’s pages
https://barba.js.org/
MIT License
11.61k stars 476 forks source link

Improve documentation on options to barba.init #745

Closed tetz2442 closed 1 month ago

tetz2442 commented 2 months ago

What version are you using?

2.10.0

What package are you using?

@barba/core

Describe your issue

Trying to find what options can be passed to barba when initializing is impossible with the current docs. There aren't any examples or explanations of what they are. There should be an option right after install or markup in the menu that explains each option you can pass. Thanks!

xavierfoucrier commented 2 months ago

Hello @tetz2442 πŸ‘‹

Thanks for opening an issue for that.

Currently we have "Developer API" documentation that list all barba.init arguments: https://barba.js.org/api/classes/core_src.core.html#init.

Of course, it would be nice to have a place in the doc where all are explained as well πŸ˜‰

tetz2442 commented 2 months ago

@xavierfoucrier thanks for the link. Even just a mention of that link somewhere would help in the docs. I spent a lot of time trying to figure out what the options were that I could pass πŸ˜…

xavierfoucrier commented 2 months ago

I can understand πŸ˜„ ... sorry about that! Documentation will be updated accordingly.

xavierfoucrier commented 1 month ago

New options page is here! πŸš€ 😎 https://barba.js.org/docs/advanced/options/