diff --git a/readme.md b/readme.md
index 7358447..f9b9164 100644
--- a/readme.md
+++ b/readme.md
@@ -4,30 +4,28 @@ Buranyaaa! If you love ironically drinking pilk (50% pepsi, 50% milk mix), or li
This is a fun project we did at hackerspace. @weaselcore did the art, @critbit made it into a PCB.
-After inserting the bottles, the eyes glow up. The bottles stay in place
+After inserting the bottles, the eyes glow up. Inserting bottles requires a bit of wiggling, since the holes are a bit skewed - after inserting, they more-or-less stay in place.
-To assmeble this, you need 2 LEDs (mounted upside down), 2x 0603 470R resistors, 2x 4pin 2.54mm headers, and a generic CR2032 battery holder.
+## how to assemble your badge
-There's also an option for using a LiPo charger PCB instead of CR2032 holder, but this is not yet supported, nor advised.
+You will need:
+* 1x Pilkbadge neko
+* 1x milk bottle, 1x bepis bottle
+* 2x LEDs, size `0603` or `0805` (soldered upside-down)
+* 2x `0603` resistors, value between 470 and 200 ohm (the brightest)
+* 2x 4pin 2.54mm headers (soldered to the bottles)
+* a generic CR2032 battery holder
+* a glued-in pin (optional)
-More documentation and repo cleanup will be done after 37C3.
+
-## Bare PCB
-![image](assets/b1.jpeg)
+On 1st revision board, there's also an option for using a LiPo charger PCB instead of CR2032 holder, but this is not supported, nor advised. Do it on your own risk.
-## KiCAD render of the backside
-![image](assets/b5.png)
+## Images
+
-Caution: the render has the LED direction marked incorrectly. if your LEDs are marked by a triangle - you have to do it the other way. I'll update the documentation after the congress - thanks, random person, for noticing this, so much!!!!!
-
-![image](assets/b6.jpg)
-
-## THE PILK IS HERE
-![image](assets/b2.jpeg)
-
-## The bottles
-![image](assets/b3.jpeg)
-
-## The pilkbadge on @weaselcore
-![image](assets/b4.jpeg)
+
+## Credits
+* Random person from CCC, whose name I will never know, but they noticed an error in previos readme. They also liked being called random person, I think. You can always open an issue, random person, to become a non-random one. Thanks!
+* Another random person who suggested that Neko Arc could also hold other items than pilk ingridients - we might add this feature in future revisions.