{"id":388264,"date":"2024-06-29T07:50:22","date_gmt":"2024-06-29T07:50:22","guid":{"rendered":"http:\/\/savepearlharbor.com\/?p=388264"},"modified":"-0001-11-30T00:00:00","modified_gmt":"-0001-11-29T21:00:00","slug":"","status":"publish","type":"post","link":"https:\/\/savepearlharbor.com\/?p=388264","title":{"rendered":"<span>A new writing method\/technology (\u201cdendrowriting\u201d), as exemplified by the YearVer site<\/span>"},"content":{"rendered":"<div><!--[--><!--]--><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-1\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">  Several years have passed since the appearance of <a href=\"https:\/\/pqmarkup.org\" rel=\"nofollow noopener noreferrer\">the first text markup language that supports \u201cdendrowriting\u201d<\/a>, but no worthwhile piece of text demonstrating the advantages of the new writing method\/technology has yet appeared.<\/p>\n<p>  The largest \u201cdendrotext\u201d was a couple of paragraphs in the <a href=\"http:\/\/pqmarkup.org\/ru\/syntax\" title=\"\u2018\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f\u2019 \u2192 \u2018\u0421\u043f\u043e\u0439\u043b\u0435\u0440\u044b (\u0440\u0430\u0437\u0432\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u043c\u044b\u0439 \u0431\u043b\u043e\u043a \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u0438)\u2019 \u2192 \u2018\u0414\u043b\u044f \u0447\u0435\u0433\u043e \u043d\u0443\u0436\u043d\u0430 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u044f\u044f \u0444\u043e\u0440\u043c\u0430\u2019 \u2192 \u0441\u043c. \u0441\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442 \u043f\u043e\u0441\u043b\u0435 \u0441\u043b\u043e\u0432\u0430 \u2018\u0434\u0440\u0435\u0432\u043e\u0432\u0438\u0434\u043d\u043e\u2019\" rel=\"nofollow noopener noreferrer\">pqmarkup documentation<\/a>, consisting of only ~1300 characters and available only in Russian.<\/p>\n<p>  In English there was no \u201cdendrotext\u201d at all, as such <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">apart from small insertions in the documentation for the 11l programming language (e.g., \u2018Boolean type\u2019 in <a href=\"http:\/\/11l-lang.org\/doc\/built-in-types\" rel=\"nofollow noopener noreferrer\">Built-in types<\/a>)<\/font><font color=\"#BFBFBF\">]<\/font>.<\/p>\n<p>  But last year&#8230;<br \/>  <a name=\"habracut\"><\/a><br \/>  \u2026 when I was tidying up the <abbr title=\"specifically the version numbers and status [Beta\/Stable]\">meta-information<\/abbr> for my projects, I noticed that I had settled on recording version numbers in <code>YYYY.M[.n]<\/code> form. Then I got the idea of giving this designation a name: YearVer <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">obviously, by analogy with SemVer<\/font><font color=\"#BFBFBF\">]<\/font>. And the rule for naming additional versions {published in the same month or fixing bugs in the main version} formed the basis of the text for a new website.<\/p>\n<p>  Soon after, I learned about the existence of CalVer from the <a href=\"https:\/\/en.wikipedia.org\/wiki\/Software_versioning\" rel=\"nofollow noopener noreferrer\">Software versioning page on Wikipedia<\/a>. This disappointed me a little, but when I took a closer look I found out that <a href=\"https:\/\/calver.org\" rel=\"nofollow noopener noreferrer\">calver.org<\/a> does not give any specific recommendations about which \u201ccalendar versioning\u201d scheme should be used, but simply describes the schemes already used in various projects, without highlighting them in any way.<br \/>  The creation of a site for YearVer thus remained relevant, and I continued to fill it with content.<\/p>\n<p>  The resulting description of the YearVer versioning scheme turned out to be quite short and concise, but very definite, offering specific schemes\/strategies depending on the type of project.<\/p>\n<p>  And the most challenging task was now to translate the yearver.org\/ru page into English, preserving the formatting.<\/p>\n<p>  To obtain a high-quality translation, I decided to contact three different translation agencies at once and to emphasize the fact that I was interested in maximum quality and <abbr title=\"for the sake of fairness I should say it was only the second and third translation agencies I told I was prepared to pay extra for quality; in my message to Alconost I just indicated that \u2018I need a very small text translated, but to a very high quality\u2019\">prepared to pay extra<\/abbr> for it.<br \/>  I contacted:  <\/p>\n<ul>\n<li>Alconost (it was the first link in Google search results for \u2018\u0431\u044e\u0440\u043e \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u043e\u0432 \u0441\u0430\u0439\u0442\u043e\u0432\u2019\\\u2018website translation agency\u2019)<\/li>\n<li>transly.ru and tran.su (found by searching for \u2018\u0431\u044e\u0440\u043e \u043f\u0435\u0440\u0435\u0432\u043e\u0434\u043e\u0432 markdown\u2019\\\u2018translation agency markdown\u2019)<\/li>\n<\/ul>\n<p>  In the process of communicating with the first translation agency, the rules for reading \u201cdendrotext\u201d were formulated:  <\/p>\n<ol>\n<li>Hidden text {&#8230;} should be expanded only after the <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">corresponding<\/font><font color=\"#BFBFBF\">]<\/font> paragraph has been read in its entirety.<\/li>\n<li>Hidden text {{&#8230;}} should be expanded after {&#8230;}.\n<p>  For example, in the following sentence <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">from <a href=\"http:\/\/yearver.org\" rel=\"nofollow noopener noreferrer\">http:\/\/yearver.org<\/a><\/font><font color=\"#BFBFBF\">]<\/font>:  <\/p>\n<blockquote><p>Additional versions published in the same month, or {\u2026} those fixing bugs of the main version {\u2026}, shall be numbered <code>2021.2.1<\/code>, <code>2021.2.2<\/code>, and so on.<\/p><\/blockquote>\n<p>the second block of hidden text should be expanded (after the words \u2018main version\u2019), then all its nested blocks, and only then the first block (after the word \u2018or\u2019).  <\/p>\n<div class=\"spoiler\" role=\"button\" tabindex=\"0\">                         <b class=\"spoiler_title\">Why was this \u201cdendrotext\u201d organized this way?<\/b>                         <\/p>\n<div class=\"spoiler_text\">\n<div class=\"spoiler\" role=\"button\" tabindex=\"0\">                         <b class=\"spoiler_title\">(Before reading this explanation, I strongly recommend that you read [in accordance with these rules] the indicated sentence from yearver.org in full)<\/b>                         <\/p>\n<div class=\"spoiler_text\">The second block of hidden text (after the words \u2018those fixing bugs of the main version\u2019) introduces the concept of bug-free projects, clarifying that such projects do not need bug-fixing versions. <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">And its <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">second block<\/font><font color=\"#BFBFBF\">]<\/font> could actually be placed right after the words \u2018fixing bugs\u2019 <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">{but I did not do that, since the first and second blocks of hidden text would then be too close to each other}<\/font><font color=\"#BFBFBF\">]<\/font>.<\/font><font color=\"#BFBFBF\">]<\/font><br \/>  And the first block of the hidden text relates to the word \u2018or\u2019 (therefore it is located immediately after it), but since it uses the concept of bug-free projects <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">introduced in the second block<\/font><font color=\"#BFBFBF\">]<\/font>, it should be expanded after the second block <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">which is why the first block was enclosed in additional curly braces<\/font><font color=\"#BFBFBF\">]<\/font>.  <\/div>\n<\/p><\/div>\n<\/div><\/div>\n<\/li>\n<\/ol>\n<p>  At the end <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">of the translation process<\/font><font color=\"#BFBFBF\">]<\/font> there remained the painstaking work of \u201cmerging\u201d the three translations I received into one text, choosing the best translation variants for each sentence and each term\/concept.<\/p>\n<div class=\"spoiler\" role=\"button\" tabindex=\"0\">                         <b class=\"spoiler_title\">Why \u201cdendrowriting\u201d?<\/b>                         <\/p>\n<div class=\"spoiler_text\"><i>Dendro-<\/i> <a href=\"https:\/\/www.dictionary.com\/browse\/dendro-\" title=\"&lt;- google:\u2018dendro dictionary meaning\u2019\" rel=\"nofollow noopener noreferrer\">comes<\/a> from the Greek <i>d\u00e9ndron<\/i>, meaning \u201ctree\u201d. However, if you think of a tree as a data structure <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">in programming<\/font><font color=\"#BFBFBF\">]<\/font>, then it&#8217;s really not very clear how \u201cdendrowriting\u201d relates to it. But if you take a look at ordinary\/real trees\u2026 Try to draw a vertical line on a piece of paper: that&#8217;s the trunk of the tree, and this is your text <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">a paragraph or just a sentence<\/font><font color=\"#BFBFBF\">]<\/font>. Now go from bottom to top, and once you reach the first block of hidden text, make a branch (to the left or to the right {you can alternate: the first block of hidden text branches to the left, the second to the right, the third to the left again, etc.}). Then you expand the first block of hidden text <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">bottom branch of the tree<\/font><font color=\"#BFBFBF\">]<\/font>. It can either consist of plain text or contain other blocks of hidden text corresponding to the sub-branches of the tree.<\/p>\n<div class=\"spoiler\" role=\"button\" tabindex=\"0\">                         <b class=\"spoiler_title\">And how is it different from classic spoilers (like this)?<\/b>                         <\/p>\n<div class=\"spoiler_text\">\u201cDendrowriting\u201d is blocks of hidden text within a paragraph.<br \/>  Whereas the classic spoiler is a separate paragraph in itself {but which, like a block of hidden text in \u201cdendrowriting\u201d, may contain multiple paragraphs}.  <\/div>\n<\/p><\/div>\n<\/div><\/div>\n<p><\/div>\n<\/div>\n<\/div>\n<p><!----><!----><\/div>\n<p><!----><!----><br \/> \u0441\u0441\u044b\u043b\u043a\u0430 \u043d\u0430 \u043e\u0440\u0438\u0433\u0438\u043d\u0430\u043b \u0441\u0442\u0430\u0442\u044c\u0438 <a href=\"https:\/\/habr.com\/ru\/articles\/648913\/\"> https:\/\/habr.com\/ru\/articles\/648913\/<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<div><!--[--><!--]--><\/div>\n<div id=\"post-content-body\">\n<div>\n<div class=\"article-formatted-body article-formatted-body article-formatted-body_version-1\">\n<div xmlns=\"http:\/\/www.w3.org\/1999\/xhtml\">  Several years have passed since the appearance of <a href=\"https:\/\/pqmarkup.org\" rel=\"nofollow noopener noreferrer\">the first text markup language that supports \u201cdendrowriting\u201d<\/a>, but no worthwhile piece of text demonstrating the advantages of the new writing method\/technology has yet appeared.<\/p>\n<p>  The largest \u201cdendrotext\u201d was a couple of paragraphs in the <a href=\"http:\/\/pqmarkup.org\/ru\/syntax\" title=\"\u2018\u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u0432\u043e\u0437\u043c\u043e\u0436\u043d\u043e\u0441\u0442\u0438 \u0444\u043e\u0440\u043c\u0430\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f\u2019 \u2192 \u2018\u0421\u043f\u043e\u0439\u043b\u0435\u0440\u044b (\u0440\u0430\u0437\u0432\u043e\u0440\u0430\u0447\u0438\u0432\u0430\u0435\u043c\u044b\u0439 \u0431\u043b\u043e\u043a \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u0438)\u2019 \u2192 \u2018\u0414\u043b\u044f \u0447\u0435\u0433\u043e \u043d\u0443\u0436\u043d\u0430 \u043f\u043e\u0441\u043b\u0435\u0434\u043d\u044f\u044f \u0444\u043e\u0440\u043c\u0430\u2019 \u2192 \u0441\u043c. \u0441\u043a\u0440\u044b\u0442\u044b\u0439 \u0442\u0435\u043a\u0441\u0442 \u043f\u043e\u0441\u043b\u0435 \u0441\u043b\u043e\u0432\u0430 \u2018\u0434\u0440\u0435\u0432\u043e\u0432\u0438\u0434\u043d\u043e\u2019\" rel=\"nofollow noopener noreferrer\">pqmarkup documentation<\/a>, consisting of only ~1300 characters and available only in Russian.<\/p>\n<p>  In English there was no \u201cdendrotext\u201d at all, as such <font color=\"#BFBFBF\">[<\/font><font color=\"gray\">apart from small insertions in the documentation for the 11l programming language (e.g., \u2018Boolean type\u2019 in <a href=\"http:\/\/11l-lang.org\/doc\/built-in-types\" rel=\"nofollow noopener noreferrer\">Built-in types<\/a>)<\/font><font color=\"#BFBFBF\">]<\/font>.<\/p>\n<p>  But last year&#8230;  <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[],"tags":[],"class_list":["post-388264","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/388264","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=388264"}],"version-history":[{"count":0,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=\/wp\/v2\/posts\/388264\/revisions"}],"wp:attachment":[{"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=388264"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=388264"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/savepearlharbor.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=388264"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}