Update the new-puzzle checklist for the post-bob world.
[sgt/puzzles] / CHECKLST.txt
1 Useful checklists
2 =================
3
4 Things to remember when adding a new puzzle
5 -------------------------------------------
6
7 Write the source file for the new puzzle (duhh).
8
9 Create a .R file for it which:
10 - defines a Recipe symbol for it if it requires auxiliary object
11 files
12 - adds it to the `ALL' definition, to ensure it is compiled into
13 the OS X binary
14 - adds it as a GTK build target
15 - adds it as a Windows build target
16 - adds auxiliary solver binaries if any
17 - adds it to $(GAMES) in the GTK makefile, for `make install'
18 - adds it to list.c for the OS X binary
19 - adds it to wingames.lst for the build system.
20
21 If the puzzle is by a new author, modify the copyright notice in
22 LICENCE and in puzzles.but. (Also in index.html, but that's listed
23 below under website changes.)
24
25 Double-check that the game structure name in the source file has
26 been renamed from `nullgame', so that it'll work on OS X. Actually
27 compiling it on OS X would be a good way to check this, if
28 convenient.
29
30 Add a documentation section in puzzles.but.
31
32 Make sure there's a Windows help topic name defined in puzzles.but,
33 and that it's referenced by the help topic field in the game
34 structure in the source file.
35
36 Add the new Unix binary name to the svn:ignore property.
37
38 Make a screenshot:
39 - create an appropriate save file in `icons'
40 - add the puzzle name to icons/Makefile
41 - set up a REDO property in icons/Makefile if desired
42
43 Don't forget to `svn add' the new source file, the new .R file and
44 the save file in `icons', and any other new files that might have
45 been involved.
46
47 Check in!
48
49 Put the puzzle on the web:
50 - run puzzlesnap first
51 - make sure the screenshot and Windows binary have arrived in the
52 www directory
53 - add an entry in the puzzles list in index.html
54 - adjust the copyright in index.html if the puzzle is by a new
55 author
56 - test that the binary link and the docs link work
57 - run webupdate
58 - test again
59 - check in the change to index.html