Yes, I agree. It’s a bit of a compromise at the moment. The table layout on the final output has fixed equal divisions that makes more than 2 columns illegible (issue here: Table column width · Issue #58 · canonical-web-and-design/docs.snapcraft.io · GitHub).
We did experiment with other layouts (see List and table presentation ideas) and settled on the above as a stop-gap. I’ll try and push the table rendering issue up the priority list so we can do a better job of this and its related tables.