D 2021-03-22T06:15:02.852
L contribute
N text/x-markdown
U mario
W 1779
## Contributions

This project hinges on an updated cookiecutters database. Unfortunately
that's quite time-consuming. So new templates might not find their way
in here - without feedback/submissions from authors.

Not sure if there's enough interest, but this would require either
automating the database build, or providing a submission API. Or both.


### Automation

 * There's the [dev/ scripts](https://fossil.include-once.org/cookiedough/wiki/dev)
   as basis.
 * Ideally it would be rewritten to also support BitBucket/GitLab/etc.
    * The lack of common API is a real showstopper though.
    * (I don't blame GitHub alone.)
    * And obviously there's no library that interfaces with all alike.
 * Wouldn't be too difficult to bring this into the GUI even. (Though it
   takes around half an hour to collect project repositories on GH.)


### Submit API

 * It might be easiest to query individual projects, and just provide a
   submission endpoint.
 * The fossil repository is SQLite-based, so would allow nearby storage.
 * Albeit you would still need a moderation step, rather than automatic
   updates for the main [uidata.json](wiki/uidata).
 * Or possibly just use the fossil ticket or forum feature.
     * In which case, you could help out by reviewing/approving tickets.

### Join

 * If interested, register a repository account here (no email necessary).
 * Drop a mail for developer elevation;
 * Read up on [fossil usage](https://fossil-scm.org/home/doc/trunk/www/quickstart.wiki).
 * It's significantly easier than git, and you can't easily break things.


### Manual submissions

For now: you can send in a full [JSON blob](wiki/uidata) per email (see
LICENSE), if you want your template be updated or added.

Z 06339c2adc1fcca8b5de5956328a7718