docs: Complete Documentation Rewrite

[cutterbl]

This is an exhaustive overhaul of documentation of Big Calendar. Here's the basic highlights:

• All documentation has been moved to Storybook
• Storybook has been upgraded
• All previous Examples have been updated and included
• Stories, with mdx docs and specific examples, have been created for every prop
• Addon stories, to include examples and prop stories, have been created for DnD
• Guide stories have been created to talk about Custom Styling, Custom Views, information about Big Calendar and Dates, and a guide on dealing with Timezones
• General documentation contribution guidelines have been included
• A GitHub workflow is included that will automatically build and deploy documentation to GitHub pages, after successful Release workflow (requires review and discussion with @jquense)

@jquense There is an issue with testing, after some of the dependency upgrades, that appear directly related to the babel-preset-jason preset in conjunction with Babel and Jest.

Submitting this now for review/help/feedback.

Note: This does require a yarn install for fresh dependencies

[ziga-miklic]

Should the new docs include info about the utility functions? For example, we found the firstVisibleDay() and lastVisibleDay() useful in our project to get the current date range.

I also did a quick StackOverflow / GitHub search and it appears that others are using them as well.

[cutterbl]

@ziga-miklic With all date math now being handled directly from the localizer, it might be a good idea to write some extensive localizer documentation. Good suggestion, I'll take a look at that.

[ziga-miklic]

@cutterbl Thank you for adding the docs for the Localizer utility methods. 👏 This would give us all the info we needed for our past use case.

I left a few comments of things that I noticed when reading the docs. Please take a look.

I also noticed that the "Run examples locally" section in README.md may need to be updated as it's still referencing the yarn examples command that has been removed in this PR.

[cutterbl]

@ziga-miklic Nice catches on all of those. Late night/early morning fat fingering. Good to have second set of eyes. Thanks for looking out.

[jquense]

@cutterbl there is really too much for me to look at here, i'm sure it's great. this is effectively your repro now, so don't wait on me for anything 👍

[cutterbl]

@jquense Appreciate the vote of confidence there. As the owner though, only you can control the settings for the GitHub Pages, which is the final item in question here.

[jquense]

what specifically do you need me to check or toggle? happy to do it

[cutterbl]

@jquense just need to know what folder is setup with the 'gh-pages' branch in your Pages settings. I figure it's 'root', but need to know for sure so I don't take down the docs site.

[jquense]

it is root 👍 let me know if you want it to be something else

[github-actions]

🎉 This PR is included in version 0.39.4 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀

[cutterbl]

@jquense New docs are live

[jquense]

they look great! awesome work 👍

[dpd73]

Great work people. Dates/Timezone stuff particularly useful.

FYI, small typo on https://jquense.github.io/react-big-calendar/examples/index.html?path=/story/guides-understanding-dates--page

...culture, regarless of any offsets.

should be "regardless"