Establish Five and a fake company as a narrative to facilitate docs comprehension
Current Behavior
It can be a challenge to document, screenshot, and explain features without a set of pre-established actors - a pre-established story with fake users, teams, and organizations in which to explain functionality. Lucky for us, we have an opportunity to create a continuous narrative in Layer5 Docs by incorporating our mascot, Five, into our docs.
Implementation
- Develop a small narrative around Five, his team, surrounding teams, and organization. This narrative can be illustrative in explaining features like workspaces, environments, users, teams, roles and so forth.
- Publish this narrative in both the Kanvas and Cloud doc sets.
- Start infusing this narrative into the documentation. Open new issues to suggest and track where our mascot can be helpful in explaining concepts.
- A collection of Five illustrations that can be sourced where approrpriate - https://layer5.io/company/brand (bottom of page)
Example
Microsoft documentation uses "Contoso" as a fake organization to aid in the explanation of concepts throughout its product docs.
Contributor Guide and Resources
- π Instructions for contributing to documentation
- π¨ Wireframes and designs for Layer5 site in Figma (open invite)
- ππΎππΌ Questions: Layer5 Discussion Forum and Layer5 Community Slack
@leecalcote can you assign me this one?
Sounds great. Thanks much for jumping in and volunteering. In an effort to help guarantee your success in undertaking assignment of the issue, will you:
- confirm that you're able to build the project, specifically, the components necessary to resolve this issue.
- confirm the approach you intend to take to resolve the issue - a draft of the narrative would be great.
I want to work on it kindly assign me this
@Souradip121, See https://github.com/layer5io/docs/issues/457#issuecomment-2776687005