Skip to content

Docs request: "Quick start" guide for technical setup #948

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

Open
sjspielman opened this issue Dec 17, 2024 · 1 comment
Open

Docs request: "Quick start" guide for technical setup #948

sjspielman opened this issue Dec 17, 2024 · 1 comment

Comments

@sjspielman
Copy link
Member

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).

@sjspielman
Copy link
Member Author

Tagging @dvenprasad

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

No branches or pull requests

1 participant