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

docs: update images using latest UI screenshots #1992

Merged
merged 49 commits into from
Sep 14, 2022

Conversation

nicolaesocaciu
Copy link
Contributor

@nicolaesocaciu nicolaesocaciu commented Aug 29, 2022

Updating images in the documentation using the latest UI screenshots

https://linear.app/unleash/issue/1-6/update-images-in-the-docs

@vercel
Copy link

vercel bot commented Aug 29, 2022

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Updated
unleash ✅ Ready (Inspect) Visit Preview Sep 14, 2022 at 7:54AM (UTC)
unleash-docs ✅ Ready (Inspect) Visit Preview Sep 14, 2022 at 7:54AM (UTC)
1 Ignored Deployment
Name Status Preview Updated
unleash-monorepo-frontend ⬜️ Ignored (Inspect) Sep 14, 2022 at 7:54AM (UTC)

@github-actions
Copy link

github-actions bot commented Aug 29, 2022

Coverage report

St.
Category Percentage Covered / Total
🟢 Statements
88.76% (-2.62% 🔻)
6859/7728
🟡 Branches 79.35% 1095/1380
🟢 Functions
82.39% (-3.83% 🔻)
1928/2340
🟢 Lines
89.11% (-2.2% 🔻)
6356/7133

⚠️ Details were not displayed: the report size has exceeded the limit.

Test suite run success

1146 tests passing in 188 suites.

Report generated by 🧪jest coverage report action from 975bef9

Copy link
Contributor

@thomasheartman thomasheartman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work on this and lots of nice things you've caught 🙌🏼

I think I've either updated everything you've requested or asked for clarification if I'm not sure or if I disagree.

Just a few things to note in general (I think I saw a few of these):

  1. Try and avoid words like "click" (consider "select" or "use"; you can't click if you don't have a mouse 🐭 ) and "see" (not everyone has functioning eyesight 👀 )
  2. When updating (and changing images), make sure the alt text still applies or update it if it doesn't 😄

@@ -27,7 +27,7 @@ curl -X POST -H "Content-Type: application/json" \
https://app.unleash-hosted.com/demo/api/admin/features/Demo/toggle/on
```

**Great success!** We have now enabled the feature toggle. We can also verify that it was actually changed by the API user by navigating to the history (audit log) for this feature toggle.
**Great success!** We have now enabled the feature toggle. We can also verify that it was actually changed by the API user by navigating to the Event log (history) for this feature toggle.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
**Great success!** We have now enabled the feature toggle. We can also verify that it was actually changed by the API user by navigating to the Event log (history) for this feature toggle.
**Great success!** We have now enabled the feature toggle. We can also verify that it was actually changed by the API user by navigating to the event log for this feature toggle.

@@ -2,7 +2,7 @@
id: audit_log
title: The audit log
---

@Thomas - should we call the page Event log instead? and replace all the text "audit log" with -> "event log"?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, I think that makes sense. We call it 'event log' in the UI, at least.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've done this in 72aefaf.

@@ -18,3 +18,5 @@ You can find archived toggles in the toggle archive. The archive is accessible f
If you want to re-use a feature toggle that you previously archived, you can revive in from the feature toggle archive. Click the "revive icon" to revive the toggle. Revived toggles will be in the disabled state when you re-enable them.

![A list of archived toggles. Each toggle displays its name and project it belongs to. Each toggle also has a \"revive\" button, as highlighted by a red arrow.](/img/archive-toggle-revive.png 'Reviving a Feature Toggle').

@Thomas, maybe to explain also that now we can delete a feature toggle, and what are the consequences [i can prepare the screens, you can just put some screenshots and i will add the final ones]
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good! I've addressed this and will let you take care of the rest
.

website/docs/advanced/archived-toggles.md Show resolved Hide resolved
website/docs/advanced/custom-activation-strategy.md Outdated Show resolved Hide resolved
@@ -260,6 +260,7 @@ Follow steps outlined in the [Run Unleash with Docker](#run-unleash-with-docker)
![The Unleash UI showing a dropdown menu under the Configure menu entry. The dropdown menu's API Access option is highlighted and you're told to navigate there.](/img/api_access_navigation.png 'Navigate to the API access page.')

Next, create an API key with these details
@Thomas - token type needs to be updated based on the new screen

- **name:** proxy-key (this can be whatever you want)
- **token type:** client
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- **token type:** client
- **what do you want to connect** server-side SDK (CLIENT)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@NicolaeUnleash is this what you meant?

@@ -15,8 +15,8 @@ A toggle being (potentially) stale, does not affect how it performs in your appl


## The technical debt dashboard

In order to assist with removing unused feature toggles, Unleash provides a technical debt dashboard in the management-ui. You can find it by clicking on “Advanced” in the top-line menu then choose _Reporting_ in the dropdown menu.
@Thomas - is this technical debt dashboard still the correct naming? (wouldn't make more sens to updat it Health? in the entire page)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How about a compromise? Change the title to "Technical debt and project health"? Or maybe just "project health"? 🤔

@@ -22,7 +22,7 @@ Before you can connect your application to Unleash you need a Unleash server. Yo
### System Overview {#system-overview}

![A visual overview of an Unleash system as described in the following paragraph.](/img/unleash-architecture.svg 'System Overview')

@Thomas - we need to review the text here, i updated the image (new: the orange text and one more option/setup)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I did some stuff in 7f6794a which I think should cover it. Let me know if you disagree 😄

website/docs/user_guide/user-management.md Outdated Show resolved Hide resolved
website/docs/user_guide/user-management.md Outdated Show resolved Hide resolved
Co-authored-by: Thomas Heartman <thomas@getunleash.ai>
nicolaesocaciu and others added 4 commits September 14, 2022 10:45
Co-authored-by: Thomas Heartman <thomas@getunleash.ai>
Co-authored-by: Thomas Heartman <thomas@getunleash.ai>
Co-authored-by: Thomas Heartman <thomas@getunleash.ai>
Copy link
Contributor

@thomasheartman thomasheartman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super duper! 🦸🏼 🙌🏼

@nicolaesocaciu nicolaesocaciu enabled auto-merge (squash) September 14, 2022 07:56
@nicolaesocaciu nicolaesocaciu merged commit 51c7ea0 into main Sep 14, 2022
@nicolaesocaciu nicolaesocaciu deleted the docs-update-images-set1 branch September 14, 2022 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

None yet

4 participants