Thank you for considering listing your puzzles at site.name.

The process for each puzzle is simple: 
- ensure the puzzle url passes the [#Puzzle Submission Checklist]
- then press the provided **submit button** in [kudamono editor]'s [[export]] menu.

Lastly, if you are not the author of the puzzle, please obtain the author's permission before submitting, and identify yourself in the transcription metadata field ´´B=´´.


## What to expect

You puzzle will immediately appear in the front page, as well as in the [Newest 12 puzzles page|new].

Once the puzzle is displaced by more recent ones, it will move to the corresponding genre page (there may be some delay as the process is not yet automatic).

## Puzzle submission checklist

For each puzzle url, please:
- [#add metadata],
- [#vouch for uniqueness],
- [#include the solution].


### Add metadata

Please give your puzzle:
	- a Title
	- a Date
	- an Author
	- an Author
	- a Difficulty
	- optionally, other [Metadata Fields|manual#metadata]


### Vouch for uniqueness

Please double-check **the solution is unique**.
If you are not sure, please ask a friend to testsolve your puzzle.

|:info: Do not ask site.author to check uniqueness for you. This would subtract time for implementing new genres, variants and features.


### Include the solution

Simply ensure the puzzle is in its solved state at the moment of submission.

|:info: Included solutions may be used to test future genre updates, contributing to the robustness of the Kudamono Editor.



## Puzzle design tips

Carefully hand-crafted puzzles will always be well-received.

For good results, a tried-and-tested method is [#Forward Design].

### Forward Design

The method of forward puzzle design is very simple. Starting with a blank puzzle, perform the following cycle:
 - place a single clue
 - solve as much of the puzzle as possible with the new information
The cycle stops when the puzzle is complete. At that point, placing more clues would be impossible or redundant.

|:info: In forward design, you never start with the solution. Even if you have a particular solution or deduction in mind, you have to gradually reach it by strategically placing clues, one by one, as part of the cycle above.


### Computer-aided design

Under the mantra **quality over quantity**, algorithmically-generated puzzles are especially welcome when:
- human curation/post-editing culled any puzzles but those with the nicest solve paths;
- the algorithm was instrumental to reach ambitious puzzle design goals:
	- cross-genre puzzles (doppels, trippels, quadruppels, and so on)
	- searching for rare puzzle properties, like minimal clues
	- enforcing very constrained symmetries/layouts for thematic purposes
	- etc...


## Changes
**2024-11-01** Moved the Kudamono Puzzle Submission Guidelines into a separate page, and expanded a bit on the forward design method for puzzles.
**2025-05-01** Puzzle submissions from now on use the new submission button provided in the Kudamono Editor instead - thanks @PinkHoodie for feedback!