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

Add nebari user personas #460

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Add nebari user personas #460

wants to merge 4 commits into from

Conversation

kcpevey
Copy link
Contributor

@kcpevey kcpevey commented May 17, 2024

We have personas that we created a while back but they were never published externally. This is just a copy of those personas (previously in notion) out to the public docs. I did not change any wording.

Reference Issues or PRs

Resolves #455

What does this implement/fix?

Put a x in the boxes that apply

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds a feature)
  • Breaking change (fix or feature that would cause existing features not to work as expected)
  • Documentation Update
  • Code style update (formatting, renaming)
  • Refactoring (no functional changes, no API changes)
  • Build related changes
  • Other (please describe):

Testing

  • Did you test the pull request locally?
  • Did you add new tests?

Documentation

This IS documentation

Access-centered content checklist

Text styling

  • The content is written with plain language (where relevant).
  • If there are headers, they use the proper header tags (with only one level-one header: H1 or # in markdown).
  • All links describe where they link to (for example, check the Nebari website).
  • This content adheres to the Nebari style guides.

Non-text content

  • All content is represented as text (for example, images need alt text, and videos need captions or descriptive transcripts).
  • If there are emojis, there are not more than three in a row.
  • Don't use flashing GIFs or videos.
  • If the content were to be read as plain text, it still makes sense, and no information is missing.

Any other comments?

Copy link

netlify bot commented May 17, 2024

Deploy Preview for nebari-docs ready!

Name Link
🔨 Latest commit 66d1c12
🔍 Latest deploy log https://app.netlify.com/sites/nebari-docs/deploys/6675b1ede3f41b0008d14d21
😎 Deploy Preview https://deploy-preview-460--nebari-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@kcpevey
Copy link
Contributor Author

kcpevey commented May 17, 2024

One concern I have is that the images have a transparent background so in dark mode it gets a little weird. I dont have software to fix that, but maybe someone else does?

image

@kcpevey
Copy link
Contributor Author

kcpevey commented Jun 11, 2024

I got some help from Smera on this. She has suggested I use the css tag background-color: var(--ifm-color-background-3); applied to the individual images.

@kcpevey
Copy link
Contributor Author

kcpevey commented Jun 12, 2024

@pavithraes or @viniciusdc this is ready for review.

@kcpevey kcpevey added the needs: review 👀 This PR is complete and ready for reviewing label Jun 21, 2024
@viniciusdc
Copy link
Contributor

viniciusdc commented Jul 23, 2024

Hi @kcpevey, can you refresh me on why we need this again? Also, would it be possible to consolidate all personas into a single md file? It gets weird in the sidebar menu, with many names without any context... for a second, I thought I had some colleagues I had never talked to. XD

@kcpevey
Copy link
Contributor Author

kcpevey commented Jul 23, 2024

User personas helps to understand user stories on nebari usecases. These were created by the team a couple years ago and saved in our private notion docs. I was merely publishing them, which is why they are split out into individual pages - I just copied the currently existing notion pages.

That said, I can understand it does seem like a lot. I can collapse it down to one if you'd prefer?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area: documentation 📖 content: doc/reference Diataxis - reference needs: review 👀 This PR is complete and ready for reviewing
Projects
Status: Todo 📬
Development

Successfully merging this pull request may close these issues.

[DOC] - Add user personas to docs
2 participants