You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
What is the documentation improvement or update you wish to see?
I am opening this issue to suggest we consider adding a form of "quick-start setup" guide for technical setup. We have a lot of documentation spread out for setup over several pages, and it may be easy to get lost in navigating these especially when there's jumping back and forth among pages in potentially disparate parts of the docs.
Is there any additional context you would like to provide?
This suggestion is brought to you by feedback from our newest contributor @cansavvy while getting set up locally to contribute to OpenScPCA. Specifically, she was getting lost along the way to set up AWS CLI and offered this feedback:
I think what a little bit throws me off is there's not really a quick start or a linear set of steps I can follow. It's clearly very incredibly thorough but my brain is mush and I am just trying to get going.
She suggested only to add this section, not remove anything existing:
...I think keep it as is but have a "quick start" which I'm happy to be the test dummy for. The thoroughness is great but for someone like me who has 0% knowledge on the project its a tad overwhelming
I wondered that this page might effectively be the kind of quick-start guide they're looking for, which would suggest we need to do a better job making folks aware of this page. But:
I was beginning to follow this page yes, and found it quite helpful but then because its full of links I quickly lost it when I had to go to other pages to follow the steps
This suggests all the jumping around from this page makes it unhelpful as a "quick-start" page, since it becomes "not quick" fairly quickly...if you will.
If this request is for an existing documentation page, please provide the link here.
This generally refers to our technical setup section, but is also related to our "Getting Started" pages which introduce AWS onboarding (but not CLI setup, which is in technical).
The text was updated successfully, but these errors were encountered:
What is the documentation improvement or update you wish to see?
I am opening this issue to suggest we consider adding a form of "quick-start setup" guide for technical setup. We have a lot of documentation spread out for setup over several pages, and it may be easy to get lost in navigating these especially when there's jumping back and forth among pages in potentially disparate parts of the docs.
Is there any additional context you would like to provide?
This suggestion is brought to you by feedback from our newest contributor @cansavvy while getting set up locally to contribute to OpenScPCA. Specifically, she was getting lost along the way to set up AWS CLI and offered this feedback:
She suggested only to add this section, not remove anything existing:
I wondered that this page might effectively be the kind of quick-start guide they're looking for, which would suggest we need to do a better job making folks aware of this page. But:
This suggests all the jumping around from this page makes it unhelpful as a "quick-start" page, since it becomes "not quick" fairly quickly...if you will.
If this request is for an existing documentation page, please provide the link here.
This generally refers to our technical setup section, but is also related to our "Getting Started" pages which introduce AWS onboarding (but not CLI setup, which is in technical).
The text was updated successfully, but these errors were encountered: