From 7e6c54764e44da0e69455a9e11f58109f2a80315 Mon Sep 17 00:00:00 2001 From: per1234 Date: Wed, 6 Feb 2019 01:51:01 -0800 Subject: [PATCH] Establish a standard for the use of blank lines to separate sections Blank lines were used inconsistently and unnecessarily in the reference example. I have attempted to decipher the intended spacing standard and apply this across the document. This proposal establishes an official style. If accepted, I will apply it across all the reference pages, where this sort of inconsistency is widespread. --- .../Reference_Terms/AsciiDoc_Template-Single_Entity.adoc | 7 +------ 1 file changed, 1 insertion(+), 6 deletions(-) diff --git a/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc b/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc index f13b90bc6..d08fe8850 100644 --- a/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc +++ b/AsciiDoc_sample/Reference_Terms/AsciiDoc_Template-Single_Entity.adoc @@ -12,8 +12,6 @@ subCategories: [ "Subcategory Name" ] - - // PAGE TITLE = title @@ -56,7 +54,6 @@ Nothing - // HOW TO USE SECTION STARTS [#howtouse] -- @@ -66,7 +63,6 @@ Nothing // Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Sets the output to the LED proportional to the value read from the potentiometer. - [source,arduino] // Add relevant code that exemplify the use of the Reference term, // Please note that sometimes when copy-pasting code, a few spaces can be added at the beginnng of each line of code. @@ -102,6 +98,7 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption=" // HOW TO USE SECTION ENDS + // SEE ALSO SECTION [#see_also] -- @@ -112,7 +109,6 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption=" // definitions: (please add the tag #DEFINITION#), and examples of Projects and Tutorials // examples: (please add the tag #EXAMPLE#) - [role="language"] // Whenever you want to link to another Reference term, or more in general to a relative link, // use the syntax shown below. Please note that the file format is subsituted by attribute. @@ -133,4 +129,3 @@ image::http://arduino.cc/en/uploads/Main/ArduinoUno_R3_Front_450px.jpg[caption=" -- // SEE ALSO SECTION ENDS -