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

Newcomer flow #71

Open
patrick-g-h opened this issue Jul 30, 2018 · 5 comments
Open

Newcomer flow #71

patrick-g-h opened this issue Jul 30, 2018 · 5 comments
Labels
documentation tasks relating to improving our documentation enhancement requests to add something new to the project help-wanted if you're looking to help us, these are great places to start!

Comments

@patrick-g-h
Copy link
Collaborator

With the constantly growing number of resources about BIDS, I thought it would be useful to organise the "flow" that we expect newcomers to follow -- starting from Googling "what is BIDS" to finding their answer.

This is just a rough skeleton so far, but happy to hear any input related to this!

image

@dorahermes
Copy link
Member

Nice, maybe note the extensions somewhere?

@KirstieJane
Copy link
Member

@dorahermes - I don't think the extensions are high priority for newcomers... I do think they should be mentioned in the wiki but if they fit into this image they should be pretty far down.

@Park-Patrick - I think this is great - I wonder if you could make a little video of the pathway??

What are your thoughts about extending the picture? I feel like you could add more details but it might become this super overwhelming image??

If you did add I think these would be sensible:

  • How to ask a question (or check where questions have already been asked)
    • Could be nested in the README
  • How to contribute
    • Could be nested in README
  • A "table of contents" for the wiki so its clear what the wiki contains

And then going further (linking to @dorahermes' suggestion):

  • BIDS Apps
  • Extensions

@KirstieJane KirstieJane added enhancement requests to add something new to the project help-wanted if you're looking to help us, these are great places to start! documentation tasks relating to improving our documentation labels Aug 1, 2018
@dorahermes
Copy link
Member

+1 on extensions pretty far down and keeping this as high level as possible.

Examples, however, are one of the first things I point people to?

@chrisgorgo
Copy link
Contributor

Just to clarify: is this what we think users are doing or what we would like users to do?

@KirstieJane
Copy link
Member

@chrisfilo - I guess a realistic combination of the two!!

Can you expand on how the two options are different? What should we be considering?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation tasks relating to improving our documentation enhancement requests to add something new to the project help-wanted if you're looking to help us, these are great places to start!
Projects
None yet
Development

No branches or pull requests

4 participants