> This comment is not strictly related to this, but I think the docs
> could benefit from more use of
>     (1) numbered lists (to specify stepwise Howto descriptions)
>     (2) use of <code>, <samp>, <kbd> and other HTML codes to single
> out normal descriptive text from code text etc. Currently, one must
> think too much when reading ...

I agree with you. It's clearer to use the right semantic markup, also
considering the wiki restrictions. That's the way I'm changing the
docs, but there's a lot of work ahead.

>     (3) probably a defined way to write the docs should be set up.

I suggested that to Dan, the author of BoltWire. We should think about
some easy guidelines and markups to be used by the people willing to
help with the docs. In fact such a guide should be published in the
site.

Marcos

http://alinome.net
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"BoltWire" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/boltwire?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to