TOCright rules?

[Roy_043]

What are the rules regarding TOCright? On some pages it is (almost) the first element (https://www.freecadweb.org/wiki/WikiPages). On others it comes after the first paragraph (https://www.freecadweb.org/wiki/Draft_Module). Sometimes it is in the middle of the first paragraph (https://www.freecadweb.org/wiki/Import_ ... Preference).

[Kunda1]

Many pages have a:

Code: Select all

==Description== 

1 or 
2 lines of text

[[Image:foobar.png]]

== Usage ==

Depending on how large the above [[Image]] and how much text is in the Description itself, I try to pintpoint where there are large gaps in whitespace to fill with the TOC. In general I aim the TOC to be right under the ==Description== outside of translation tags

So something like:

Code: Select all

==Description== 

</translation>
{{TOCright}}
<translation>

1 or 
2 lines of text

[[Image:foobar.png]]

== Usage ==

Note: we're dealing with floating objects, so it's not an exact science.

[vocx]

What are the rules regarding TOCright? On some pages it is (almost) the first element (https://www.freecadweb.org/wiki/WikiPages). On others it comes after the first paragraph (https://www.freecadweb.org/wiki/Draft_Module). Sometimes it is in the middle of the first paragraph (https://www.freecadweb.org/wiki/Import_ ... Preference).

There are no hard rules. I personally think that it should go to the right of the first section in a document. Normally the first section is something like an Introduction or Description, so after this first paragraph, which should be short, is a good place to put it.

About Draft Module and the rest of the workbench main pages, I dislike the big icon that Kunda added. It pushes the text down too much, leaving a ton of empty space. Consequently the {{TOCright}} is also too far down, which doesn't look good. I wanted users to start reading the introduction of the workbench and at the same time look at the table of contents, not stare at a giant icon.

[kaktus]

Hi.


hyymmmm
You touched on the icon that identifies the workplace.
I liked the change.

A lot of people have visual memory, and they learn how to recognize modules.

But since you've paid attention to it, so maybe it would be worth making this icon a little smaller.

It'll be a good compromise.

[Kunda1]

The size of the icon can be diminished, no problem. The text being pushed down is made more severe due to wiki markup newline drama coupled with the translation extension that we use, which demarcates a translation portion with an HTML comment proceeded by and followed by a new line. So we end up having tons of superfluous whitespace