Build a slick website showcasing the power of mobx.dart about mobx.dart

[pavanpodila]

BTW, I am also very tempted to try out Docz. It's still markdown, so we can reuse most of the README.md files. Let me know if you want to give that a shot :-)

[pavanpodila]

This is also a good time to revisit the logo, if needed

[chimon2000]

Would the site be in this repo or elsewhere?

[chimon2000]

As an alternative to Gatsby, have you looked at Docsify?

It's obviously not as popular, but it offers some of the same benefits and it's focused specifically on documentation.

[rrousselGit]

FWIW docs.flutter.io is actually generated from dartdoc

[chimon2000]

Also important to note that flutter.io uses Jekyll.

dartdoc seems like a good candidate if the idea is to maintain a consistent stack, generate documentation from comments, and minimize customization.

With the other options mentioned, documentation becomes a bit more explicit. On the flipside, classes can potentially become quite large when filled with examples & documentation.

[chimon2000]

@pavanpodila

I have been building a site based off of the README updates, take a look at what I have so far:

https://well-cruiser.glitch.me/

Important things to note here is that this is 100% generated from README's so there is no need to fudge with any extra technologies (Gatsby, Vuepress, Docusaurus, etc.)

[pavanpodila]

@chimon2000 This looks great! Can we do any tweaks in theming and formatting?

[chimon2000]

Yes. I have not played around with the styling too much but it shouldn't be terribly hard. I will submit a PR.

The default styling is based off Medium.css