4 ms·
Thank you for releasing a project into the wild! :) Without getting into a long-winded rant about good docs, here are some things that you could do on your pag
by angersock 10y ago
Thank you for releasing a project into the wild! :)
Without getting into a long-winded rant about good docs, here are some things that you could do on your page:
Make it clear what your library adds over Bootstrap. There are a lot of similar sorts of things out there, and it isn't immediately obvious what yours brings to the table. Give an executive summary with concrete details of functionality in your introduction, i.e., "This adds better footers, calls-to-action, and useful templates for prototyping not found in vanilla Bootstrap".
Consider embedding the code snippets instead of linking to Github. If you want, embed the snippets as gists or similar, but linking out to Github is a little weird for what should be short example code.
Consider moving the component explanations above the FAQ stuff. It's hard to imagine that people will want to know if they can contribute code or money without having seen the actual product in use.
Best of luck!
- pryelluw 10y agoWow, thanks for this feedback. It is exactly what I was looking to hear.