Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 127 lines (105 sloc) 5.209 kB
8dbde0b @docelic - Makefile:
docelic authored
1
e976408 @docelic Evening commit
docelic authored
2 Outstanding:
3 - Interpolate/reparse are two options; adjust ROW_INTERPOLATE/REPARSE_0/1
4 - Online examples only have to be standard examples, with actual work in
5 practice if condition=online
6 Code to do that is: <programlisting><textobject><textdata fileref="pathto.xml"/></textobject></programlisting>
6445a04 @docelic Large commit.
docelic authored
7
e976408 @docelic Evening commit
docelic authored
8 - Ask ndw about including [NEW!] and [TODO!] in titles in TOC.
e680b7a @docelic - bin/stattree:
docelic authored
9
72a7f52 @docelic - Turn 2. starts: TODO items
docelic authored
10 - Stinky manpage stylesheets are a disaster. This time it's that
11 <cmdsynopsis> is verbatim and <screen> still renders comments without
12 newlines! I mean, what the... (And &copy; is translated to crap instead
16b446f @docelic - Makefile:
docelic authored
13 of plain "C"). Will need to write XSLT to fix that, and support tables.
e976408 @docelic Evening commit
docelic authored
14 NEWS: New guy took over xslt maintenance and is interested in improved
15 manpage support - he's interested in my problems, and is willing to
16 do xslt work himself.
17
898f3ed @docelic - documenting Banner Rotation
docelic authored
18 - ./files/ directory is not properly referenced from chunked documents.
e976408 @docelic Evening commit
docelic authored
19 This will be done by prefixing links from chunked documents with ../
20 "Code" for this is done, I just need to get it from ndw.
eb6346c @docelic - guides/xmldocs.xml: Update completely for up-to-dateness
docelic authored
21
c783be1 @docelic - guides/iccattut.xml: correctness corrected at few places :)
docelic authored
22 - In iccattut:
23 - make a "translation map" of /etc/interchange/* to RPM-equivs.
24 - item for package names, like interchange-cat-foundation, wenglish, etc..
b4fe42d @docelic - bin/refs-autogen:
docelic authored
25 ( This is ok, docbook 4.4 will have <package> element )
26 - explain syntax accepted in profile files
322e4c6 @docelic - bin/refs-autogen: don't warn about missing 'refs/NAME/control' file if
docelic authored
27 - Fix ImageDir and include one picture for example
e976408 @docelic Evening commit
docelic authored
28 - <Racke>I name three things that IC users often didn't acknowledge:
29 namespaces (CGI, Values, Scratch)
30 parsing order ([L], variables, lists) - interpolation
31 inventing syntax doesn't buy you anything
32 IC is _not_ a programming language
33 - how to delete item from cart in all possible ways
34 - give examples for the tasks in 'do yourself' section (in progress)
35 - give good practices about filtering, security
36 - see problems from old docs/TODO notes on iccattut
37 - ICCATTUT MUST NOT STOP WHERE it stops now. it needs to show all stuff
38 from current "excercise for readers" section, and also many more things.
322e4c6 @docelic - bin/refs-autogen: don't warn about missing 'refs/NAME/control' file if
docelic authored
39
40 - in source contexts, wrap runaway lines
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
41 - match style (no starting verb or all starting verbs) in all Example titles
42 - check if all Default fields are properly formated (<literal> or none)
43 - s/a HTML/an HTML/
e680b7a @docelic - bin/stattree:
docelic authored
44 - script to [un]comment debug lines!!
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
45
46 GLOSSARY:
47 Say about accesskeys in html source, for key-based navigation
48 tag, interpolation, reparse, symbol types
49 catalog/global variable, tag,ui,
50 action, form, unix inet socket, values,
e976408 @docelic Evening commit
docelic authored
51 regex, flypage, sku
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
52
53 - More:
54 Programming guidelines doc - integrate with programming style. Advise
55 programmers of choices to make in order to make their code play well with
56 IC - for example, if they want to have a field in the DB for images,
57 advise them to name the column 'image' because other tags (they might or
58 might not later use) take that as default value. etc...
59 guide on setting complete IC environment
60 style: leave newline at end of file
61 explain version naming.. stable/unstable and how 5.3.0 implies next stable
e680b7a @docelic - bin/stattree:
docelic authored
62 Documentation on how to create replicated catalog online and at your
63 desktop machine for ultimate convenience.
64 - PRODUCE PATCH TO RECOMPILE OFFICIAL DISTRIBUTION PERL without threads.
a0f2502 @docelic A large commit with many enhancements:
docelic authored
65
81e9a5e @docelic refs/area:
docelic authored
66 DOCUMENTATION SYSTEM:
970185e @docelic - bin/refs-autogen:
docelic authored
67 - Add support to document tags which are NOT found in separate files
81e9a5e @docelic refs/area:
docelic authored
68 (like [restrict] or [subject]).
e8f63ad @docelic - bin/stattree:
docelic authored
69 - Read all possible options for tag files from vend/config.pm
70 (%tag.* structures) and warn if invalid option is found in any tag file.
a6a00ca @docelic LARGE COMMIT:
docelic authored
71
fbf7c6b @docelic - guides/iccattut.xml: corrections found by aspell
docelic authored
72
73
dc2ec38 @docelic - Makefile:
docelic authored
74 Mid-term:
75 - for "online" docs, also provide a form where users can add comments or
76 ask for clarification. (this could be done with either pure IC (forum?), or
7b35729 @docelic - Makefile: added support for howtos
docelic authored
77 XML forms capability, or wiki?)..
09c6b9a @docelic - bin/stattree and bin/refs-autogen:
docelic authored
78 - in html, make source contexts "rollable" by either using some css
79 properties or javascript. this is not really needed when you only have
7b35729 @docelic - Makefile: added support for howtos
docelic authored
80 say, 15 lines of context, but it'll come great when you have a copy
81 of a 300-lines usertag. Example for this could be taken directly out of
82 mwforum demo on mwforum.org
16b446f @docelic - Makefile:
docelic authored
83 - Generate leaf nodes (put bin/mkreport back in action)
e8f63ad @docelic - bin/stattree:
docelic authored
84
85 Tags:
81e9a5e @docelic refs/area:
docelic authored
86 aliases
87 tag call / perl call / mvasp
88 container
89 has subtags
90 nests
e8f63ad @docelic - bin/stattree:
docelic authored
91
e680b7a @docelic - bin/stattree:
docelic authored
92
93
e976408 @docelic Evening commit
docelic authored
94 Ideas:
e680b7a @docelic - bin/stattree:
docelic authored
95 - In db_columns: add exlude_columns= parameter?
e976408 @docelic Evening commit
docelic authored
96 - New docs:
97 - promotional
98 - new developer howto
99 - filenames in Source contexts should also be clickable. this is longterm
100 because it'll involve perltidy and other stuff I have in mind ...
101
e680b7a @docelic - bin/stattree:
docelic authored
102
e976408 @docelic Evening commit
docelic authored
103 Notes:
104 - say that code is colorful collection of time and people, so docs try to fill
e680b7a @docelic - bin/stattree:
docelic authored
105 the gap.
e976408 @docelic Evening commit
docelic authored
106 - say that even though sometimes the code looks ugly/unreadable, check 3 times before thinking it's a bug
107 - ** Dan Browning: clustering howto, tuning tips (by Mike),
108 - jedit + IC colorization, commit-to-live script,
109 - Racke: performance docs NEEDED, clustering my mike needs funding or he
110 won't do it. CVS howto is browning.
111 - "In times of universal deceit, telling the truth becomes
112 a revolutionary act." -- George Orwell.
113 - For a successful technology, reality must take precedence over public
114 relations, for Nature cannot be fooled. -- Dick Feynman
115 - <epigraph>
116 <attribution>William Safire</attribution>
117 <para>
118 Knowing how things work is the basis for appreciation, and is
119 thus a source of civilized delight.
120 </para>
121 </epigraph>
122
123
124 Misc:
125 - Mike We are short on chiefs and heavy on Indians here
126
Something went wrong with that request. Please try again.