Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 158 lines (128 sloc) 6.459 kB
c52871f @docelic Some new items, good stuff.
docelic authored
1 Outstanding:
2 =======
4946375 @docelic - An easy commit to break the summer silence.
docelic authored
3 - Can *_page pragmas take ITL and not just subroutine names?
d458e36 @docelic - Documented few filters
docelic authored
4 - See that if 'crypt' is put in see also, all symbols of that name appear
5 in see also line and their type is distinguished visually.
fb2f4cb @docelic - one more glossary entry
docelic authored
6 - TAXAREA is not discovered in source by bin/stattree
7 - toc in glossary
f176a7c @docelic The usual accompanying improvements
docelic authored
8 - Make MapRoutined source contexts have Line: x-y instead of Lines: z header.
fb2f4cb @docelic - one more glossary entry
docelic authored
9 - make glossary,howto items also appear as symbols, so that you can put
10 their names in See Also and get generated links
11 - recognize situations where contexts overlap, but in a special way that
12 first example does not see the other, but the other sees the first becase
13 of 10 lines of pre-context. (example is IMAGE_MOGRIFY refentry). In those
14 cases, resize area of the context report so that it appears as one
f176a7c @docelic The usual accompanying improvements
docelic authored
15 - With confs, also include source context where it is being used
16 - Enhance stuff with acronyms
17 - Under AUTHORS, include cvs line where appropriate (guides, howtos, gloss... )
18 - In vars.html, include line if it appears in variable.txt
8a8fb40 @docelic As usual, I am wonderful ;-) Here's the reason this time:
docelic authored
19 - why email, email-raw, SendMailProgram produce errors about usertags olink ID
656e8f1 @docelic Phew, a large commit; glossary/ITL took me 4 hours.
docelic authored
20 - Add docbook element to reference mailing list posts. Something like
21 <ml list='users'>2004-December/041539</ml>, it expands to:
22 <ulink url="http://www.icdevgroup.org/pipermail/interchange-users/2004-December/041539.html">2004-December/041539</ulink>.
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
23 - match style (no starting verb or all starting verbs) in all Example titles
24 - check if all Default fields are properly formated (<literal> or none)
d2c6eee @docelic - Makefile: remove dependence on bin/stattree
docelic authored
25 - make regexp matching better, to properly scan parse_subroutine(); (gets
26 confused by { { in a substitution)
27 - in refs, replace "database" with "database_name", that kind of things
28 - import my hand-made test from /var/lib/.../pages/* to appropriate
29 ref pages as online examples
30 - At least in filters, <<EOR messes up the thing, only < is printed and stops
d458e36 @docelic - Documented few filters
docelic authored
31
32 Coding:
e680b7a @docelic - bin/stattree:
docelic authored
33 - script to [un]comment debug lines!!
238f9d5 @docelic - Added Interchange FAQ document ( guides/faq.xml ).
docelic authored
34 - use Interchange.pm to make an Interchange shell (External.pm!)
35 - finish ML stats <-- MAILPOND on ocelic2!
9cc5ea7 @docelic - Cleaned some TODO items and reorganized TODO a bit
docelic authored
36
81e9a5e @docelic refs/area:
docelic authored
37 DOCUMENTATION SYSTEM:
970185e @docelic - bin/refs-autogen:
docelic authored
38 - Add support to document tags which are NOT found in separate files
81e9a5e @docelic refs/area:
docelic authored
39 (like [restrict] or [subject]).
fbf7c6b @docelic - guides/iccattut.xml: corrections found by aspell
docelic authored
40
dc2ec38 @docelic - Makefile:
docelic authored
41 Mid-term:
c52871f @docelic Some new items, good stuff.
docelic authored
42 - Ask ndw about including [NEW!] and [TODO!] in titles in TOC. --> This is a
43 bug and it will work when they fix it.
f176a7c @docelic The usual accompanying improvements
docelic authored
44 - &glos-hello-world needs to give "hello world", not "hello-world" as text
2767140 @docelic - Makefile: remove ordercheckout document which I'll decompose to dif…
docelic authored
45 - List of mv_s, descriptions and shortcuts
dc2ec38 @docelic - Makefile:
docelic authored
46 - for "online" docs, also provide a form where users can add comments or
47 ask for clarification. (this could be done with either pure IC (forum?), or
7b35729 @docelic - Makefile: added support for howtos
docelic authored
48 XML forms capability, or wiki?)..
09c6b9a @docelic - bin/stattree and bin/refs-autogen:
docelic authored
49 - in html, make source contexts "rollable" by either using some css
50 properties or javascript. this is not really needed when you only have
7b35729 @docelic - Makefile: added support for howtos
docelic authored
51 say, 15 lines of context, but it'll come great when you have a copy
52 of a 300-lines usertag. Example for this could be taken directly out of
53 mwforum demo on mwforum.org
16b446f @docelic - Makefile:
docelic authored
54 - Generate leaf nodes (put bin/mkreport back in action)
d458e36 @docelic - Documented few filters
docelic authored
55 - If filter returns Vend::xxx::something(), include that function in context
56 reports, and try to determine the "Uses" field (which also needs to be
57 added to filter refentry template or something)
e8f63ad @docelic - bin/stattree:
docelic authored
58
59 Tags:
81e9a5e @docelic refs/area:
docelic authored
60 aliases
61 tag call / perl call / mvasp
62 container
63 has subtags
64 nests
e8f63ad @docelic - bin/stattree:
docelic authored
65
e680b7a @docelic - bin/stattree:
docelic authored
66
67
e976408 @docelic Evening commit
docelic authored
68 Ideas:
e680b7a @docelic - bin/stattree:
docelic authored
69 - In db_columns: add exlude_columns= parameter?
e976408 @docelic Evening commit
docelic authored
70 - New docs:
71 - promotional
72 - new developer howto
73 - filenames in Source contexts should also be clickable. this is longterm
74 because it'll involve perltidy and other stuff I have in mind ...
c52871f @docelic Some new items, good stuff.
docelic authored
75 - CVS page: http://www.icdevgroup.org/i/dev/cvs.html?id=auxbUMnz
76 Make a tutorial : IC from CVS, Catalog in SVN, replicated setup online
77 and locally
78 - How to deal with Safe
79 Programming guidelines doc - integrate with programming style. Advise
80 programmers of choices to make in order to make their code play well with
81 IC - for example, if they want to have a field in the DB for images,
82 advise them to name the column 'image' because other tags (they might or
83 might not later use) take that as default value. etc...
84 guide on setting complete IC environment
85 explain version naming.. stable/unstable and how 5.3.0 implies next stable
86 Documentation on how to create replicated catalog online and at your
87 desktop machine for ultimate convenience.
5f3f31f @docelic - Some new stuff, some placeholders, some updates/fixes to existing f…
docelic authored
88 - Whereever we count things, (like, valid Locale keys are decimal_point,
89 mon_grouping, price_picture,n_cs_precedes etc.) make that information
90 derived by scripting in stattree, not manually counting
e976408 @docelic Evening commit
docelic authored
91
e680b7a @docelic - bin/stattree:
docelic authored
92
e976408 @docelic Evening commit
docelic authored
93 Notes:
94 - say that code is colorful collection of time and people, so docs try to fill
e680b7a @docelic - bin/stattree:
docelic authored
95 the gap.
e976408 @docelic Evening commit
docelic authored
96 - say that even though sometimes the code looks ugly/unreadable, check 3 times before thinking it's a bug
97 - ** Dan Browning: clustering howto, tuning tips (by Mike),
98 - jedit + IC colorization, commit-to-live script,
99 - Racke: performance docs NEEDED, clustering my mike needs funding or he
100 won't do it. CVS howto is browning.
f176a7c @docelic The usual accompanying improvements
docelic authored
101
102
e976408 @docelic Evening commit
docelic authored
103 - "In times of universal deceit, telling the truth becomes
104 a revolutionary act." -- George Orwell.
105 - For a successful technology, reality must take precedence over public
106 relations, for Nature cannot be fooled. -- Dick Feynman
107
108
109 Misc:
110 - Mike We are short on chiefs and heavy on Indians here
111
5d5c2a2 @docelic - bin/stattree:
docelic authored
112
113
8a8fb40 @docelic As usual, I am wonderful ;-) Here's the reason this time:
docelic authored
114 - In iccattut:
5d5c2a2 @docelic - bin/stattree:
docelic authored
115 - Check if redhat/tarball paths are correct
116 - explain syntax accepted in profile files
117 - Fix ImageDir and include one picture for example
118 - <Racke>I name three things that IC users often didn't acknowledge:
119 namespaces (CGI, Values, Scratch)
120 parsing order ([L], variables, lists) - interpolation
121 inventing syntax doesn't buy you anything
122 IC is _not_ a programming language
123 - how to delete item from cart in all possible ways
124 - give examples for the tasks in 'do yourself' section (in progress)
125 - give good practices about filtering, security
126 - see problems from old docs/TODO notes on iccattut
127 - files/tutorial*: s/tutorial-*.log/tutorial.*.log/
128
8a8fb40 @docelic As usual, I am wonderful ;-) Here's the reason this time:
docelic authored
129 GLOSSARY:
130 Say about accesskeys in html source, for key-based navigation
131 tag, interpolation, reparse, symbol types
132 catalog/global variable, tag,ui,
133 action, form, unix inet socket, values,
134 regex, flypage, sku
135
136
137
138
139 NON DOCS RELATED
140 - Image tag, sort out mgkpath thing
f56b1e1 @docelic Just small "managemental" commit.
docelic authored
141
142
143
144 Nice but not fitting the idea
145 - CVS 'ident' command
146 - Suppress inline docs (in source) for items that have xmldocs docs
147 - In source contexts, for tags, highlight tagCanon and provide <acronym> with
148 short explanation and example
5f3f31f @docelic - Some new stuff, some placeholders, some updates/fixes to existing f…
docelic authored
149
150
151
152 In IC source:
153
154 - No $Vend::XTrailer on <input>, etc..
155 - missing </p>s
156 - lowercase SELECTED/CHECKED ?
157
Something went wrong with that request. Please try again.