Skip to content
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

Documentation of Framework #125

Open
2 tasks
aayusharora opened this issue May 16, 2018 · 7 comments
Open
2 tasks

Documentation of Framework #125

aayusharora opened this issue May 16, 2018 · 7 comments

Comments

@aayusharora
Copy link
Contributor

aayusharora commented May 16, 2018

Propose the best way to document this framework.
The codebase is split up into two major layers

elements: They are independent skeleton that are used to make objects
objects: They are the combination of elements along with the layer of layouting

PS: Some of the elements do not require to be used as an object, hence they should also be documented.

There is an approach needed to document each and every object/element that is complete in itself.
For example:
Documenting a card means:
[ HTML Code + CSS code ] represented in a well defined UI, so that anyone can use that card ( i.e making it reusable )
There should be a static page that can document each of our complete elements/objects.

  • Propose a way to document Motley elements/objects

  • Document the cards and buttons element/objects

For reference:
Check how the element section of semantic-ui is documented
https://semantic-ui.com/elements/button.html

@monsij
Copy link

monsij commented May 17, 2018

Can you please describe the requirements @aayusharora . Is a documentation required for the codebase?

@abhishek97
Copy link
Contributor

@aayusharora Take a look at http://sassdoc.com/. The comment syntax is similar to JSDoc. See if we can use it.

@Yagya-Chaudhary
Copy link

could you please briefly describe the problem?

@thenamankumar
Copy link

VuePress is there.

@aayusharora
Copy link
Contributor Author

@abhishek97 http://sassdoc.com/ looks cool, we can try this as well, Need to see what results it can produce.

@aayusharora
Copy link
Contributor Author

@monsij @Yagya-Chaudhary @hereisnaman Updated the description, please follow up

@varadpoddar
Copy link

If still open, you can use docsify. It's fairly easy to set up and create documentation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

6 participants