Skip to content

Conversation

@Sozai83
Copy link
Contributor

@Sozai83 Sozai83 commented Jan 5, 2026

The “Onboarding to SVX” page on docs.meeco.me currently links to: https://www.meeco.me/signup

This page needs to be updated to reflect the newly implemented self-sign up workflow.

@Sozai83 Sozai83 requested a review from YVLopez January 6, 2026 22:40
@YVLopez
Copy link
Contributor

YVLopez commented Jan 7, 2026

Hey @Sozai83
Thanks for drafting this! It's coming along nicely. I have added some suggestions below:

  • When creating screenshots, use a ratio that better reflects a standard screen size. Also, don't crop images, ie. don't zoom in on text fields - I find it's better to show the entire page to give context. If you are zoomed in, sometimes it's difficult for users to know which page you are on or where on a specific page. I suggest using the existing Portal Tutorials for reference, eg: https://docs.meeco.me/guides/portal-tutorials/tenant-administrators/onboard-to-a-tenancy

  • For consistency and ease of maintaining the page, I suggest removing the numbered steps. If a step changes, or is removed in future, you then have to ensure all remaining numbers are correct and they don't break etc when images are in between. Again, take a look at the existing tutorials for reference.

  • Lastly, one of your images shows placeholder text "{your email address}" - I'd suggest creating a faux persona when demonstrating the platform to ensure all information is populated.

You may not be aware, but we have guidelines in Confluence here: https://meecosystem.atlassian.net/wiki/x/ioAvkg

Please review the guidelines and update as required. Reach out to me at any time if you want to run through anything / need a second pair of eyes.

Thanks!

@Sozai83
Copy link
Contributor Author

Sozai83 commented Jan 7, 2026

Hey @Sozai83 Thanks for drafting this! It's coming along nicely. I have added some suggestions below:

  • When creating screenshots, use a ratio that better reflects a standard screen size. Also, don't crop images, ie. don't zoom in on text fields - I find it's better to show the entire page to give context. If you are zoomed in, sometimes it's difficult for users to know which page you are on or where on a specific page. I suggest using the existing Portal Tutorials for reference, eg: https://docs.meeco.me/guides/portal-tutorials/tenant-administrators/onboard-to-a-tenancy
  • For consistency and ease of maintaining the page, I suggest removing the numbered steps. If a step changes, or is removed in future, you then have to ensure all remaining numbers are correct and they don't break etc when images are in between. Again, take a look at the existing tutorials for reference.
  • Lastly, one of your images shows placeholder text "{your email address}" - I'd suggest creating a faux persona when demonstrating the platform to ensure all information is populated.

You may not be aware, but we have guidelines in Confluence here: https://meecosystem.atlassian.net/wiki/x/ioAvkg

Please review the guidelines and update as required. Reach out to me at any time if you want to run through anything / need a second pair of eyes.

Thanks!

Thank you @YVLopez !
I've revised the documentation as per your recommendations.
I hope I understood it right but if not, please feel free to let me know. Happy for you to change directly if there are anything minor change you want to make as well.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants