Brainhack Proceedings – an open & free journal for Brainhack project outcomes

[katjaq]

Project info

Title:
Brainhack Proceedings – an open & free journal for Brainhack project outcomes

Project lead:
We are a team of people leading different parts of the process :)

Project collaborators:

Agah Karakuzu	Anibal Sólon	Cameron Craddock	Isil Bilgin	katja heuer	Matteo Mancini
Pierre Bellec	Peer Herholz	Roberto Toro	Samuel Guay	Sofie Van Den Bossche

Registered Brainhack Global 2020 Event:
We are probably registered all over the place... including Ankara, Marseille, Ontario, NYC and many more 🙃

Project Description:
We are building the Brainhack Proceedings Journal – an open free publishing platform for the community to publish Brainhack project outcomes. The workflow from project to publication is entirely based on GitHub and completely open and transparent. We have implemented a first complete workflow \ö/ and are looking for 2 types of community interactions now:
(1) Some hacking projects around the platform.
For the Latex experts with love for design :) During Brainhack, would you like to join us for a little hacking session to improve the visual design of our latex template underlying the final paper pdf? While users only need to work with markdown language, the magic behind the pdf is currently latex. If you feel you could give us a hand, please come join our team.
For the Javascript lovers with interest in GitHub actions :) While we have a first workflow set up, it would be amazing to check that the web template is working, and Github actions compile the forked papers, that links are maintaining the correct targets throughout the process, and that the svg and banner scale across all pages.
(2) Some first submission tests
Brainhack proceedings is in its experimental phase. The first complete workflow is ready to be used and tested by all the amazing project outcomes from Brainhack Global: We invite everyone who would like to publish some original work coming out of the Brainhack, to come and test our workflow. Which will be the first publication featuring on the Journal website? 😃
Come and fork our template repo, fill your content, formulas and figures into the report.md file and see it magically transform into a paper preview. We have set up nice tutorials to take you by hand throughout the entire process.

Link to project repository/sources:
https://github.com/brainhack-proceedings/brainhack-proceedings.github.io

Goals for Brainhack Global 2020:

• test workflow, all Github actions pass
• test all links and check they are all linked to the submitted project
• adapt the latex template to match the web-version style of the final paper
• encourage some projects to actually submit their work :)

Good first issue
Please fix all links see this issue

Good second issue
Check that the svg banner scales correctly based on window size see this issue

Skills:

• latex and love for design
• some basics in Javascript and html
• basic markdown knowledge to replace our template with your project content & submit to test the workflow and publish your work :)

Tools/Software/Methods to Use:

• Nothing needs to be installed to use and test the workflow. It can be followed entirely online on GitHub.
• simple local server to run the journal website locally and test changes for the svg banner

Communication channels:

Project labels

• I added all of the labels I want an associate to my project

Project Submission

Submission checklist

Once the issue is submitted, please check items in this list as you add under ‘Additional project info’

• Link to your project: could be a code repository, a shared document, etc.
• Goals for Brainhack Global 2020: describe what you want to achieve during this brainhack.
• Flesh out at least 2 “good first issues”: those are tasks that do not require any prior knowledge about your project, could be defined as issues in a GitHub repository, or in a shared document.
• Skills: list skills that would be particularly suitable for your project. We ask you to include at least one non-coding skill. Use the issue labels for this purpose.

Optionally, you can also include information about:

• Number of participants required.
• Twitter-sized summary of your project pitch.
• Provide an image of your project for the Brainhack Global 2020 website.

We would like to think about how you will credit and onboard new members to your project. If you’d like to share your thoughts with future project participants, you can include information about:

• Specify how you will acknowledge contributions (e.g. listing members on a contributing page).
• Provide links to onboarding documents if you have some:
  

[complexbrains]

Fantastic! Thank you so much for adding it in Katja! All looks good! going to publish now 🤗 Also added a screen shot to go with as image for now but apparently we are also missing a nice logo that might be part of the hackathon too indeed 🤗

[katjaq]

Do you like our favicon ? I would like to use this as a logo.

And for the image, i was just about to add the link form the repo to the pattern

:) but happy if you want to go with something else :)

[katjaq]

the screenshot you added is great! thanks so much @complexbrains :) <3

[complexbrains]

I can change, but I need png :( for that. Let me know if you want me to change.

[katjaq]

no no, it looks great <3 Thanks a lot!!