-
-
Notifications
You must be signed in to change notification settings - Fork 307
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
Build a slick website showcasing the power of mobx.dart #21
Comments
This is also a good time to revisit the logo, if needed |
Would the site be in this repo or elsewhere? |
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. |
FWIW docs.flutter.io is actually generated from dartdoc |
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. |
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.) |
@chimon2000 This looks great! Can we do any tweaks in theming and formatting? |
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 |
BTW, I am also very tempted to try out Docz. It's still markdown, so we can reuse most of the |
This is the marketing site + docs. I am thinking a site in Gatsby would be good and easy to maintain over time.
The text was updated successfully, but these errors were encountered: