Hi, folks!

On your website, there at least two Markdown conventions in contentual
conflict.

At [1] in the section "Markdown Conventions", the second point says:

> * Hard wrap Markdown lines at 80 characters.

At [2] in the section "Markdown Conventions", the second point says:

> * Insert a newline at the end of each sentence.
>
>     * Rationale: This practice is most appropriate for source that
>     consists primarily of natural language text. It results in
>     the most useful diffs and facilitates translation into other
>     languages while mostly preserving source readability.

As long as there are no special reasons for these contradictory rules, I
suggest to resolve that conflict, e.g. by deleting one of those
convention lists and link to the other instead.

I prefer the latter convention point to keep (since most links point to
these [2] conventions and because of the given rationale -especially the
translation thing).


Why is this important? Well, there are lots of Markdown files with more
than one sentence per line or with partial sentences per line. Both
result in very ugly phrases to translate at Transifex. :S  To be honest,
I lose my desire to translate such things. I guess that other
translators think alike.


Kind regards,
Tobias

[1] https://github.com/QubesOS/qubesos.github.io/blob/master/README.md
[2]
https://github.com/QubesOS/qubes-doc/blob/master/basics_user/doc-guidelines.md

-- 
You received this message because you are subscribed to the Google Groups 
"qubes-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/qubes-devel/438173d4-f526-5fd6-b6c1-806c50c6ce47%40posteo.de.
For more options, visit https://groups.google.com/d/optout.

Reply via email to