[Swift-devel] A suggested web content strategy for Swift

[Mihael Hategan]

On Tue, 2011-03-01 at 11:54 -0600, Michael Wilde wrote:
> 
> ----- Original Message -----
> > For what it's worth, I think that if folks don't want docbook (which
> > I'd
> > more inclined to drop if there was any other reasonable equivalent
> > system that produces good html output),
> 
> Did you look at the reStructured text and Sphinx alternative I described, which is used by Python and many other projects?

I believe that expressing tables like this:
+--------------+----------+-----------+-----------+
| row 1, col 1 | column 2 | column 3  | column 4  |
+--------------+----------+-----------+-----------+
| row 2        | Use the command ``ls | more``.   |
+--------------+----------+-----------+-----------+
| row 3        |          |           |           |
+--------------+----------+-----------+-----------+

... is silly. You are drawing tables in text. Imagine the amount of work
required to add or remove a column.

The reason one would use this is if it would be desirable for the
documentation to look presentable in a plain text source file.