motley icon indicating copy to clipboard operation
motley copied to clipboard

Documentation of Framework

Open aayusharora opened this issue 6 years ago • 7 comments

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

aayusharora avatar May 16 '18 10:05 aayusharora

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

monsij avatar May 17 '18 10:05 monsij

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

abhishek97 avatar May 17 '18 16:05 abhishek97

could you please briefly describe the problem?

Yagya-Chaudhary avatar May 18 '18 16:05 Yagya-Chaudhary

VuePress is there.

thenamankumar avatar May 19 '18 06:05 thenamankumar

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

aayusharora avatar May 20 '18 20:05 aayusharora

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

aayusharora avatar May 20 '18 20:05 aayusharora

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

varadpoddar avatar Oct 26 '19 03:10 varadpoddar