Employee information

If you are a new employee at FabLab Barcelona, please do the following:

1. Get a free Github account. It only takes a minute! ⌚
2. Please add your profile picture on Github: https://github.com/settings/profile
3. Create an issue asking someone who has admin access to add your username to the fablabbcn organization team called Employees at https://github.com/orgs/fablabbcn/teams/employees
   • This will give you write access to some repositories, like this one and our main website.
   • This also allows you to log on to some websites via Github.
   • To upload your photo, go to the folder https://github.com/fablabbcn/fablabbcn-web/tree/master/img/team and click 'Upload files' and call it by your name.
4. Add your details in the fablabbcn-web repo
   • Go to the _data folder and open the /employees.ymlfile
   • How to edit files on Github
   • Now your information should be available on our About page: https://fablabbcn.org/about_us
5. Join our Slack channel, and again, please add your profile picture 👮
   • In Slack, click your username (top left), and Profile & Account
   • This will help people connect your name to your face 👽
   • Write a short line on the #general channel, introducing yourself and what you do!

Bonus

• Learn Markdown - We are increasingly using Markdown in our projects!
• If you like emojis, here are all the emojis that Github supports: https://gist.github.com/rxaviers/7360908 🐴

HELP

What is Github?

Github is a a place where we store data, mainly text based (code and documentation). It can also store images and videos but it is not optimized for that.

Github uses a technology called git, a version control technology to help keep history of changes to text.

Git records every change you make to a text, allowing you do undo everything, and see who changed what line at what time and why.

Git uses the term commit for changes. It is similar to using the Save button in other programs.

Why should we add our users here?

By having all our users on Github, we can manage them into multiple Teams.

Each Team can have access to repositories, and be allowed to login to websites.

Example: All members of the team called Employees can log into our Grafana monitoring service by clicking the '# with Github' button. (No need to create additional login / password.)

We could use this for more services to make user management easier.

How to edit files on Github

1. Make sure you have selected the correct file by clicking it in the repository

2. Click the pencil (edit) button on the right 📝

   

3. Make your changes

4. Click the green Commit Changes button ✔️

How do I make changes to our main website fablabbcn.org

• Our main website is 100% open with all it's content on Github
• We host our page on Github Pages
  • Every git commit to the repository will automatically go to the live page (within a minute)
• Github Pages use a Static Website generator called Jekyll
  • Jekyll has Video Walkthroughs - Watch them to learn the basics!
• We are also trying out Forestry.io and CloudCannon to handle (abstract) adding content to the website

Other links

https://github.com/fablabbcn
https://fablabbcn.org/about_us
http://rules.fablabbcn.org