Messages in this thread | | | Date | Thu, 9 Aug 2007 11:31:22 +0100 | From | Stephen Hemminger <> | Subject | Documentation files in html format? |
| |
Since the network device documentation needs a rewrite, I was thinking of using basic html format instead of just plain text. But since this would be starting an new precedent for kernel documentation, some it seemed like a worthwhile topic for discussion.
Advantages of html: * basic formatting like lists, italics, etc * easier to integrate into other places and retain formatting * ability to link documents and to external sources easier
Downsides: * can become too formatted and unclear * accessibility and translation issues? * even more style issues
- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
| |