[FIX] divide readme into 3 parts

[sappelhoff]

This is an attempt to make the README of the specification repository a bit cleaner.

• structured according to what a potential visitor might want:
  • using bids
  • asking questions
  • contributing to BIDS

What do you think? What else should be addressed?

[emdupre]

Thanks for the tag, @franklin-feingold !

Just for a little more context in reviewing: was there something that prompted this reorganization ? Is there an open issue with more detail ?

[effigies]

The context for this was an out-of-band discussion (which also led to Neurostars #5476) in which we were trying to figure out how people might get lost when coming to the various potential front-pages for BIDS, which include:

• https://bids.neuroimaging.io
• https://bids-specification.readthedocs.io
• https://github.com/bids-standard/bids-specification

I proposed (and nobody strenuously objected), that if someone gets to the repo, they probably want to know one of three things: 1) Where to find the spec; 2) How to learn about BIDS more generally; 3) How to contribute their ideas to BIDS. And we could probably make it a little easier to find resources for each.

[effigies]

This LGTM, and is definitely an improvement. I would suggest that we might want to switch from "Using" language. Some concrete suggestions:

[emdupre]

A few suggestions on phrasing and content, but overall I think delineating use cases is a great idea ! Thanks !!

[emdupre]

A suggested small typo fix 😸
Bigger general point: If the division you have in mind is "what you need to get started" vs "where to get help" why don't we do something like:

1. Rename "Formatting your data with BIDS" to "When to use BIDS" (sorry, I know I just asked you to change that !)
2. Rename "Getting Started" to "Formatting your data with BIDS"
3. Move the second heading above "As a dataset curator" i.e. around L22

I don't think this division quite maps on to what @effigies suggested above, but I personally find it a little clearer than what we have right now. WDYT ?

[franklin-feingold]

Thank you @sappelhoff for the edits! I think this will help with navigating/understanding this repo! Reading through I agree with @emdupre 1st and 3rd points.
I interpreted the first section as more aligned with usage rather than the details of formatting (the current title may suggest). Though the second section reads more as a resource/where to get help section - perhaps title proposal: Converting to BIDS resources I think the subtle distinction with adding resources makes it more clear that these identified locations are to get more information rather than the details of how to in this section

[sappelhoff]

I disregarded @franklin-feingold's proposal for the second heading for now to give him a chance to re-read this in the new format as suggested by @emdupre.

I think it's coming along well now. Thanks for the feedback all of you :)

[emdupre]

Light suggestion here would be to convert this into a sub-heading, or add one directly above it. Something like:

## Where to go to learn more

[emdupre]

One light suggestion, but this LGTM ! Would love to know what everyone else thinks.

Thanks, @sappelhoff ✨

[sappelhoff]

Thanks for your help @emdupre