Missing Contributor Guide

[shardwolfdotnet]

There's no CONTRIBUTING.md (or similar guide) in the repo, so contributors have to guess as to what's needed for new icons. This makes it hard for others outside the project to meaningfully contribute, and slows down PRs with avoidable back+forth.

Some things that would be helpful in a contributor's guide:

• Requirements for adding new icons
• SVG formatting expectations (24px grid, stroke size, stroke="currentColor", etc.)

[Jon-Corey]

I agree that documentation for contributors would be nice to have.

Details about SVG formatting expectations can be found in the Tabler Icons Design Guide.

[shardwolfdotnet]

I agree that documentation for contributors would be nice to have.

Details about SVG formatting expectations can be found in the Tabler Icons Design Guide.

This doesn't have the details I'm looking for, sadly. A manual-of-style for the icon artwork proper is a helpful start, but there's other technical/file-formatting details that are neither included in (nor appropriate to include in) the Design Guide.

For example:

• validate-icons.mjs asserts SVGs contain one of two pre-set headers (one for outlined icons, one for filled). There's no indication of this header in the GHA failure output or the Design Guide.
• Icons get unicode codepoints assigned, but it's not clear whether contributors assign these or if it happens during the release workflow.
• There's some text-formatting expectations for the SVGs proper, but figuring these out seems to be mostly trial-and-error. Again, none of these are in the Design Guide, but are still important from a technical perspective (e.g. no SVG Z command in <path>s)