add

docs/lib-shape_starburst.md

@@ -0,0 +1,39 @@
+# shape_starburst
+
+Returns shape points of a star. They can be used with xxx_extrude modules of dotSCAD. The shape points can be also used with the built-in polygon module. 
+
+## Parameters
+
+- `r1` : The outer radius of the starburst. 
+- `r2` : The inner radius of the starburst.
+- `n`  : The number of vertices. 
+
+
+## Examples
+
+	include <shape_starburst.scad>;
+	
+	polygon(shape_starburst(30, 12, 6));
+
+![shape_starburst](images/lib-shape_starburst-1.JPG)
+
+	include <shape_starburst.scad>;
+	include <circle_path.scad>;
+	include <rotate_p.scad>;
+	include <golden_spiral.scad>;
+	include <cross_sections.scad>;
+	include <polysections.scad>;
+	include <golden_spiral_extrude.scad>;
+	
+	shape_pts = shape_starburst(5, 2, 8);
+	
+	golden_spiral_extrude(
+	    shape_pts, 
+	    from = 5, 
+	    to = 10, 
+	    point_distance = 1,
+	    scale = 10
+	);
+
+![shape_pentagram](images/lib-shape_starburst-2.JPG)
+