03-06-2005, 07:24 AM
Hey Antoni... I finally got the kw_bload.xml to appear with a CVS update. I edited the file for you, so here's a few things I changed:
- Tab deliniation, for consistency. If you want to use something else we'll put it to vote.. I've just always like tabs.
- Watch out for personal pronouns. I know lillo wrote it, but still. Use passive voice if you have to.
- More basic grammer: Don't end a sentence with a preposition.
- Even more basic grammer
: Remember how and where to use semicolons.
- Use <code> for article tags. But really, most code should be in examples.
- Properly comment examples. You want people to know what you're doing.
- The ID in the header is the same name as the file. In this case, kw_bload is the id.
- If there are no revisions, leave that tag out.
- Notice the example. Line breaks are okay.
- "Sub-syntax" tags are only allowed in <syntax>, makes parsing easier
- Use <var> for parameters, unless it's like a group of keywords.
For instance, <vg> could be used like this:Code:<syntax>
<kw>Dim</kw>
<var>variable</var>
<kw>As</kw>
<vg>Data Type</vg>
</syntax>