Re: [gentoo-pms] Too many EAPIs for feature table

[Michael Orlitzky]

On 06/21/2014 04:11 AM, Ulrich Mueller wrote:
> Hi all,
> Appendix D contains a big table of EAPI features. This was already
> turned sideways when adding EAPI 3, but with EAPI 6 it will be too
> wide for the page, even in landscape mode.
>
> We could:
> - Use a smaller font size. This would be a temporary fix for EAPI 6,
>   but for the next EAPIs we would run into the problem again.
> - Split the table into two smaller tables (e.g., for EAPI 0 to 5 and
>   for EAPI 6).
> - Omit the oldest EAPIs (e.g., 0 and 1) from the table, and add a
>   reference to a previous version of the document.
>
> I'd prefer the last solution. Appendix D is only informative, and we
> still have Appendix E which will list the differences to older EAPIs.
>
> Any other opinions?
>
> BTW, with the cheat sheet we'll run into the same problem. There we
> have no other choice but omitting some of the information.

We want to be able to compare EAPIs at a glance, so they all need to be
side-by-side or atop one another. Two unrelated features, on the other
hand, can safely appear pages apart.

So my suggestion is to switch "Feature" and "EAPIs"; then, when you run
out of horizontal space (too many features), repeat the headers. The
features/references are in one-to-one correspondence so they don't need
to appear as a row/column in the table:


                  Feature (Reference)
 EAPI | feature1 (ref1) | feature2 (ref2) | feature3 (ref3)
-----------------------------------------------------------
   0  |       yes       |        no       |    whatever
   1  |
   2  |
   3  |
   4  |              ...
   5  |
   6  |
-----------------------------------------------------------
                  Feature (Reference)
 EAPI | feature4 (ref4) | feature5 (ref5) | feature6 (ref6)
-----------------------------------------------------------
   0  |       yes       |        no       |    whatever
   1  |
   2  |
   3  |
   4  |              ...
   5  |
   6  |