Things HSF-India collaborators should do to connect
This page is for HSF-India collaborators, normally faculty or staff that will serve as mentors for students on projects. Prospective students do not need to add themselves as collaborators. A separate part of the website will soon be added for that.
New HSF-India collaborators need to do some number of things to get connected. This webpage documents the things that need to be done. If you find there are steps not mentioned here, or missing/unclear information, please contribute an improvement!
- You should make a pull request to the Research Software Collaborations website GitHub repository. The elements should be:
- Add a photo named
assets/images/teamfolder. It should be 320x240 pixels and in general should be less than 100kB.
- Add a “
<your github username>.md” file to the
_collaboratorsfolder in the website repository. See below for an example of the frontmatter.
- Following the frontmatter part, the markdown part of the file is free-form,
however most people should add a “### Biography” and a “### Project interests” section. You can find examples for other people in the
_collaboratorsarea. In general the biography can be short if you are including a link to your website (see frontmatter example below) and that has the relevant details. For project interests, all are welcome, but particular emphasis on connections to the current HSF-India themes will help in building collaborations.
- Add your GitHub username to the corresponding file in
_institutes. Note that you will not show up in the full team page if you are not in one of the files there! If your university or institute is missing, please ask the website admins.
- Add your GitHub username to any relevant files in
_networks. If you think that an additional network is needed, please ask the website admins at firstname.lastname@example.org.
- Add a photo named
- An example of the frontmatter for the _collaborator markdown file is:
--- layout: collaborator active: true institution: <Your University> name: <Your name> photo: /assets/images/team/<First name>-<Last name>.jpg shortname: <Your GitHub user ID> title: <Can be blank - will show a title under your picture> website: <Optional, your website> github-username: <Your GitHub user ID> presentations: - title: How to make green eggs and ham date: 2018-09-10 url: https://indico.cern.ch/event/697389/contributions/3062046/attachments/1712602/2761531/ROOT2018-Union.pdf meeting: ROOT 2018 Users Workshop meetingurl: https://cern.ch/root2018 project: greeneggs focus-area: as location: Virtual ---
- To receive announcements regarding the HSF-India project and other activities to build research software collaborations, please subscribe to the email@example.com mailing list. You will probably have to log in to Google before being able to subscribe. If you have problems, please write the website admins at firstname.lastname@example.org. We can subscribe people by hand if necessary.
There is a section for presentations in the file you created above. For totally new collaborators this section should likely be left blank, however we include info about it here for use later as people engage with the HSF-India project.
We would like to keep track of presentations made by HSF-India collaborators, with the following criteria:
- Only presentations related to HSF-India itself and projects catalyzed by HSF-India should be included.
- Any presentation in a “public” meeting should be included. This includes presentations made in experiment meetings, even if they are protected such that the presentation and meeting links are not world visible.
- Presentations in the HSF-India topical meetings should be included.
- Minor presentations in internal “working” meetings of HSF-India do not need to be added.
- Presentations, lectures, etc. as part of training events should be included.
- Posters at workshops and conferences can also be included. You can add “(poster)” at the end of the title. Include a link to a pdf of the poster.
The meaning of the fields is the following:
- title - the title of the talk: you made need to place it in double quotes if certain characters like a colon space “: “ are included in the title.
- date - the date on which the presentation was made, in the numeric format “YYYY-MM-DD”.
- url - this should be a direct URL to the presentation or page containing the presentation. For Indico, link to the contribution, not the PDF or other links.
- meeting - the name of the meeting.
- meetingurl - the URL for the meeting in which the presentation was made.
- location - optionally list the location of a meeting if it was a workshop or dedicated gathering. Meetings that are mostly in Vidyo can use “Virtual”.
- focus-area - optionally list the relevant focus area for this presentation, using its short name, i.e. one of [ia,ssl,ssc,doma,as,osglhc,blueprint,core]. Can be a list, leave blank if none.
- project - optionally list the relevant project for this presentation, using its short name, i.e. those found in the pages/projects/ area. Can be a list, leave blank if none.