Skip to content
This repository has been archived by the owner on Jun 7, 2022. It is now read-only.

Style Guide: Create a template for component README #75

Closed
psealock opened this issue May 23, 2018 · 2 comments
Closed

Style Guide: Create a template for component README #75

psealock opened this issue May 23, 2018 · 2 comments

Comments

@psealock
Copy link
Collaborator

If all components have READMEs with the same layout and style, it will make finding information more useful.

@justinshreve justinshreve added this to Backlog in Isotope May 23, 2018
@ryelle
Copy link
Member

ryelle commented Jul 11, 2018

We have two basic approaches, example 1 and example 2

Both have:

  • Component Name
  • Short description of component
  • Optional, reasoning for why the component exists/when to use, or any special requirements for use
  • Example of how to use the component
  • Details about the props

The biggest difference is in the props display. I think we should go with a table format after all, maybe something modeled after the react-docgen-markdown-renderer output, in the hopes we can use something like that eventually 🙂

Prop Type Required Default Description
title string * (none) The title of this section
options object Options for example rendering
options.count number 2 A count of items for demo

@ryelle
Copy link
Member

ryelle commented Sep 6, 2018

Now that we're generating docs from inline comments, we can close this. 🎉

@ryelle ryelle closed this as completed Sep 6, 2018
Isotope automation moved this from Project Backlog 🔙 to 👻Sprint 3 Done Sep 6, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants