Hi,
is there anywhere a $subject?
My first question is: is it better to leave an empty line under section titles or not? I would like to see pros and cons. Is there a consensus for preferred way? (I think source code style guides are primarily within the scope of programmers and not in that of users without programming experience, that's why I ask here.)
Kinda depends on whether you're asking for Wikimedia-specific rules or general MediaWiki rules.
Speaking just about Wikimedia, each local wiki community may have different preferences. There is no process for enforcing global (meaning, cross-wiki) recommendations in this regard, so in practice, even if someone from the technical community came up with universal rules, no one would really need to stick to them, and if they did and their contribution was reverted, the argument from these rules could be ignored.
Best,
Szymon Grabarczuk (he/him)
Lead Movement Communications Specialist (Product & Tech)
Wikimedia Foundation https://wikimediafoundation.org/
On Thu, Jun 27, 2024 at 11:34 AM Bináris wikiposta@gmail.com wrote:
Hi,
is there anywhere a $subject?
My first question is: is it better to leave an empty line under section titles or not? I would like to see pros and cons. Is there a consensus for preferred way? (I think source code style guides are primarily within the scope of programmers and not in that of users without programming experience, that's why I ask here.)
-- Bináris _______________________________________________ Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
Pe joi, 27 iunie 2024, Bináris wikiposta@gmail.com a scris:
Hi, is there anywhere a $subject?
Even if it exists, it is moot. For instance, for templates you can specify the layout from the docs, but it is not enforced in the wikitext editors. One can always edit through an external editor and put the elements however they like.
That being said, Parsoid is pretty stubborn wrt to layout. You wouldn't believe the number of people aligning the equal sign in the templates they add and how angry they get when VE "ruins" there carefully crafted layout.
My first question is: is it better to leave an empty line under section
titles or not? I would like to see pros and cons. Is there a consensus for preferred way?
I would not leave spurious empty lines in any circumstances, as there are a million ways they can cause havoc later. For example, section contents can be transcluded, and if there is an empty line before the transclusion, you will end up with an extra paragraph.
(I think source code style guides are primarily within the scope of
programmers and not in that of users without programming experience, that's why I ask here.)
-- Bináris
For what it's worth: the Translate extension page at https://www.mediawiki.org/wiki/Help:Extension:Translate/Page_translation_exa... claims that there should be a blank line after section titles so that the extension can consider titles as separate elements than text because "Adding a blank line allows translators to know when they can take a break. Plus it prevents issues with wikitext."
On Thu, Jun 27, 2024 at 11:58 AM Strainu strainu10@gmail.com wrote:
Pe joi, 27 iunie 2024, Bináris wikiposta@gmail.com a scris:
Hi, is there anywhere a $subject?
Even if it exists, it is moot. For instance, for templates you can specify the layout from the docs, but it is not enforced in the wikitext editors. One can always edit through an external editor and put the elements however they like.
That being said, Parsoid is pretty stubborn wrt to layout. You wouldn't believe the number of people aligning the equal sign in the templates they add and how angry they get when VE "ruins" there carefully crafted layout.
My first question is: is it better to leave an empty line under section
titles or not? I would like to see pros and cons. Is there a consensus for preferred way?
I would not leave spurious empty lines in any circumstances, as there are a million ways they can cause havoc later. For example, section contents can be transcluded, and if there is an empty line before the transclusion, you will end up with an extra paragraph.
(I think source code style guides are primarily within the scope of
programmers and not in that of users without programming experience, that's why I ask here.)
-- Bináris _______________________________________________
Wikitech-l mailing list -- wikitech-l@lists.wikimedia.org To unsubscribe send an email to wikitech-l-leave@lists.wikimedia.org https://lists.wikimedia.org/postorius/lists/wikitech-l.lists.wikimedia.org/
wikitech-l@lists.wikimedia.org