Add neuroblueprint blog.

[JoeZiminski]

This blog gives motivation for and introduction to NeuroBlueprint. It is the first of two related blog-posts introducing NeuroBlueprint/ datashuttle.

It's aims are to:

• Motivate the need for NeuroBlueprint / convince researchers of the benefits of standardisation
• Give a breif introduction to the schema and how it slots into existing initiatives
• Makes it easy for people to take the next steps towards using NeuroBlueprint

We (myself and Niko) are not strongly tied to any particular part of the existing draft so as much feedback as possible would be great. This is first real outreach on NeuroBlueprint so important to get this right to convince those at the SWC this is an endevour worth pursuing.

The docs can be built in the usual way:

1. clone the repo, cd to the docs folder
2. pip install -r requirements.txt
3. sphinx-build source build
4. Open the index.html page in the build directory, nagivate to 'Blog' and select this blog post

[alessandrofelder]

Nice - very clear 👏
Found 1 typo (I think)

[adamltyson]

Very nice. I've left a few small comments. A general comment about the blog, when I render it, the new blog is on the bottom. It should be in reverse chronological order, with new posts at the top. I think the brainglobe blog has this, so there may be some config to copy.

Also, the author doesn't show up in the blog summary for some reason (it does for @lauraporta's older post).

Lastly, it's pretty long (and with more to come!). I didn't see any obvious sections to cut, but while edits are being made, it would be good to see if there are any ways of making it a bit more concise.

[JoeZiminski]

BTW @adamltyson the index order issue has been resolved by adding dates, would you mind re-building and checking this also
resolves #83?

[adamltyson]

@JoeZiminski yep, the dates look fine. It just needs the date of this blog updating, and the author adding.

[JoeZiminski]

@JoeZiminski yep, the dates look fine. It just needs the date of this blog updating, and the author adding.

Okay great, at present Laura's name appears as it is the first line under the title in the blog page. The blog index then displays this as an 'excerpt'. Alternatively we can show the authors autoformatted by ABlog and have a different excerpt that is more like a subtitle.

Happy to include authors in the 'excerpt' position or instead autoformat the names in the index title and use the excerpt as a subtitle (we can ask @lauraporta for one for the MATLAB page). I think I have a slight preference for including the name autoformatted by ABlog and writing a custom excerpt.

[adamltyson]

@JoeZiminski yep, the dates look fine. It just needs the date of this blog updating, and the author adding.

Okay great, at present Laura's name appears as it is the first line under the title in the blog page. The blog index then displays this as an 'excerpt'. Alternatively we can show the authors autoformatted by ABlog and have a different excerpt that is more like a subtitle.

Happy to include authors in the 'excerpt' position or instead autoformat the names in the index title and use the excerpt as a subtitle (we can ask @lauraporta for one for the MATLAB page). I think I have a slight preference for including the name autoformatted by ABlog and writing a custom excerpt.

I vote for the Ablog style (as it links to other posts by the author too), and ask @lauraporta nicely for an excerpt.

[JoeZiminski]

@lauraporta has kindly agreed to supply a subtitle, will add in new PR after this is merged. Will do a final readthrough of this tomorrow and merge!

[lauraporta]

Sorry for missing this thread.|
I'm happy to readapt the MATLAB blogpost to include a subtitle, and as @JoeZiminski said, I'll open a PR to correct it after this one is merged.

[JoeZiminski]

Hey @niksirbi I could not get control of the author order, it is interchanging randomly I think for this reason. As a workaround we could set the author as 'Niko Sirmpilatze & Joe Ziminski' and vice-versa for the datashuttle blog. The only problem with this is it treats this as a single name for lookups, and so clicking the name on the index will take you to an author 'Niko Sirmpilatze & Joe Ziminski' which is not the same as 'Joe Ziminski & Niko Sirmpilatze '. Maybe this is a sufficient workaround for the time being.

[JoeZiminski]

@niksirbi this is fixed now good to go!

[niksirbi]

Wow thanks for opening and fixing the issue upstream @JoeZiminski !