docs(shorthand): add dedicated shorthand docs page

[levithomason]

Shorthand props are at the heart of what makes our API so powerful and easy to work with. With the recent updates and additions to our factories, the shorthand concept is becoming the crux of this library. We're set to only further improve shorthand for arrays, child keys, and prop types. Understanding how to use it is paramount to using Semantic-UI-React.

Shorthand is covered briefly half way down the introduction page. However, it is incomplete and deserves more prominence. We should add a dedicated "Shorthand" page under "Getting Started".

[levithomason]

Include information and examples from #882.

[levithomason]

Include an input example, see #1386.

[brianespinosa]

@levithomason Assigning this old one over to myself. I'll see about putting something together to help with this.

[brianespinosa]

I've officially blocked out a day to work on some of this over the holiday. 🎁 🎉

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 30 days if no further activity occurs. Thank you for your contributions.

[brianespinosa]

Poking myself to keep this open.

[stale]

There has been no activity in this thread for 90 days. While we care about every issue and we’d love to see this fixed, the core team’s time is limited so we have to focus our attention on the issues that are most pressing. Therefore, we will likely not be able to get to this one.

However, PRs for this issue will of course be accepted and welcome!

If there is no more activity in the next 90 days, this issue will be closed automatically for housekeeping. To prevent this, simply leave a reply here. Thanks!

[layershifter]

Unstale, please :cat

[brianespinosa]

@layershifter I saw you mention elsewhere that you were thinking about changing to docs to be built with Gatsby. Is that something you are still considering?

If so, we might want to look into something like MDX files to generate our docs. I actually am putting something together with my team that does this right now internally.

[layershifter]

@brianespinosa we using ReactStatic now.

We can adopt MDX files there, just add an additional loader: https://github.com/Semantic-Org/Semantic-UI-React/blob/master/static.webpack.js#L41

I don't have there a strategy for this now. Feel free to promote it 👍

[brianespinosa]

Ah got it. Let me see how things pan out with our internal work first and once I have some more feedback on pros/cons I can put a proposal together.

[layershifter]

@brianespinosa MDX support is added, #3196 ✌️

[stale]

There has been no activity in this thread for 180 days. While we care about every issue and we’d love to see this fixed, the core team’s time is limited so we have to focus our attention on the issues that are most pressing. Therefore, we will likely not be able to get to this one.

However, PRs for this issue will of course be accepted and welcome!

If there is no more activity in the next 180 days, this issue will be closed automatically for housekeeping. To prevent this, simply leave a reply here. Thanks!