Updated READMEs in Text group

Author: Bobrovsky

Samples/Text/CharacterSpacing/README.md

@@ -1,4 +1,12 @@
-# Character spacing
-This sample shows how to change character spacing using PdfCanvas.CharacterSpacing property.
+# Change character spacing of PDF canvas in C# and VB.NET
 
-Character spacing defines a distance between adjacent characters in a line of text.
+This sample shows how to change character spacing using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
+
+## Description
+
+Use the [PdfCanvas.CharacterSpacing](https://api.docotic.com/pdfcanvas-characterspacing) property to specify the amount of space to add to each glyph’s displacement. The character spacing defines a distance between adjacent characters in a line of text.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Using horizontal scaling for PDF text in C# and VB.NET](/Samples/Text/TextHorizontalScaling)
+* [Change word spacing on a PDF canvas in C# and VB.NET](/Samples/Text/WordSpacing)

Samples/Text/DrawText/README.md

@@ -1,6 +1,15 @@
-# Draw text
-This sample shows how to draw text on a canvas.
+# Draw text on PDF canvas in C# and VB.NET
 
-To draw text on a canvas, use PdfCanvas.DrawString or PdfCanvas.DrawText method. These methods draw text using current canvas font.
+This sample shows how to draw text on a canvas using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
 
-DrawString method draws a single line of text from the current text position (take a look at PdfCanvas.TextPosition property) or inscribed in specified rectangle. DrawText method allows to draw multiple lines of text.
+The code uses Canvas API that can add text to any PDF document. If you are going to create a new PDF, then consider using Layout API that can [make PDF generation easier](https://bitmiracle.com/pdf-library/layout/).
+
+## Description
+
+To draw text on a canvas, use the [PdfCanvas.DrawString](https://api.docotic.com/pdfcanvas-drawstring) or [PdfCanvas.DrawText](https://api.docotic.com/pdfcanvas-drawtext) methods. These methods draw text using the [current canvas font](https://api.docotic.com/pdfcanvas-font).
+
+`DrawString` methods draw a single line of text either from the [current text position](https://api.docotic.com/pdfcanvas-textposition) or inscribed in the specified rectangle. The `DrawText` method can draw multiple lines of text.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Add new text](https://bitmiracle.com/pdf-library/edit/#add-text)

Samples/Text/DrawTextFromBaseline/README.md

@@ -1,10 +1,17 @@
-# Draw text from baseline
+# Draw text from the baseline in C# and VB.NET
+
 This sample shows how to draw text starting at font's baseline.
 
-PdfCanvas.DrawString method draws string starting at left-top corner of the text rectangle. To draw text starting at font's baseline, calculate the distance between the baseline and the top coordinate of the text rectangle.
+## Description
+
+[PdfCanvas.DrawString](https://api.docotic.com/pdfcanvas-drawstring) methods draw text starting at the left-top corner of the text rectangle. To draw text starting at font's baseline, calculate the distance between the baseline and the top coordinate of the text rectangle.
+
+The [PdfFont.TopSideBearing](https://api.docotic.com/pdffont-topsidebearing) property retrieves the distance between the baseline and the top of the font's bounding box. `TopSideBearing` expressed in the glyph coordinate system. Use the value of the [PdfFont.TransformationMatrix](https://api.docotic.com/pdffont-transformationmatrix) property to map `TopSideBearing` to the canvas coordinate system.
 
-PdfFont.TopSideBearing property retrieves the distance between the baseline and the top of the font's bounding box. TopSideBearing expressed in the glyph coordinate system. Use PdfFont.TransformationMatrix to map TopSideBearing to the canvas coordinate system.
+For all PDF fonts except some tricky Type3 fonts, `TransformationMatrix` has the following structure: `{ M11, 0, 0, M22, 0, 0 }`. For such fonts, map `TopSideBearing` to the canvas coordinate system using this formula: `font.TopSideBearing * font.TransformationMatrix.M22 * canvas.FontSize`.
 
-For all PDF fonts except some tricky Type3 fonts, TransformationMatrix has the following structure: { M11, 0, 0, M22, 0, 0 }. For such fonts, map TopSideBearing to the canvas coordinate system by this formula: font.TopSideBearing * font.TransformationMatrix.M22 * canvas.FontSize.
+With `TopSideBearing`, expressed in the canvas coordinate system, you can draw text using a `DrawString` method. Convert the baseline coordinate to the top coordinate of the text rectangle using this formula: `top = (baselineY - topSideBearingCanvasSpace)`. Finally, use calculated top coordinate for a `DrawString` call to draw text starting at the baseline position.
 
-With TopSideBearing, expressed in the canvas coordinate system, you can draw text using DrawString method. Convert baseline coordinate to the top coordinate of the text rectangle by this formula: top = (baselineY - topSideBearingCanvasSpace). Finally, pass calculated top coordinate to DrawString method to draw text starting at the baseline position.
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Draw text on PDF canvas in C# and VB.NET](/Samples/Text/DrawText)

Samples/Text/EmbedFonts/README.md

@@ -1,16 +1,16 @@
 # Embed PDF fonts in C# and VB.NET
 This sample shows how to embed fonts in a PDF document using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
 
-Use [PdfFont.Embed()](https://bitmiracle.com/pdf-library/api/pdffont-embed) method to embed the given font in a PDF document.
-By default, this method uses [SystemFontLoader](https://bitmiracle.com/pdf-library/api/systemfontloader) to load bytes for TrueType/OpenType fonts.
+Use the [PdfFont.Embed](https://api.docotic.com/pdffont-embed) method to embed a font in a PDF document.
+By default, this method uses [SystemFontLoader](https://api.docotic.com/systemfontloader) to load bytes for TrueType/OpenType fonts.
 
 This sample shows how to embed TrueType font bytes using fonts from a custom directory.
 
 Embedding of PDF fonts is useful when you need to:
 * Display or print a PDF document consistently on any devices.
 * Fix an existing PDF document with non-embedded fonts.
 * Replace an existing PDF font subset with a full font to use in editable form fields.
-* Produce PDF/A document.
+* Produce a PDF/A document.
 
 Note that embedding of PDF fonts can significantly increase an output file size.
 

Samples/Text/ExtractText/README.md

@@ -1,11 +1,11 @@
 # Convert PDF to text in C# and VB.NET
-This sample shows how to extract text from PDF document or from a PDF page in C# and VB.NET.
+This sample shows how to extract text from a PDF document or from a PDF page in C# and VB.NET.
 
-Use [PdfDocument.GetText()](https://bitmiracle.com/pdf-library/api/pdfdocument-gettext) or [PdfPage.GetText()](https://bitmiracle.com/pdf-library/api/pdfpage-gettext) methods to extract text in plain text format. You can also use [PdfCanvas.GetTextData() method](https://bitmiracle.com/pdf-library/api/pdfcanvas-gettextdata) to extract text chunks with their coordinates.
+Use [PdfDocument.GetText](https://api.docotic.com/pdfdocument-gettext) or [PdfPage.GetText](https://api.docotic.com/pdfpage-gettext) methods to extract text in plain text format. You can also use [PdfCanvas.GetTextData method](https://api.docotic.com/pdfcanvas-gettextdata) to extract text chunks with their coordinates.
 
-Alternative methods are [PdfDocument.GetTextWithFormatting()](https://bitmiracle.com/pdf-library/api/pdfdocument-gettextwithformatting) and [PdfPage.GetTextWithFormatting()](https://bitmiracle.com/pdf-library/api/pdfpage-gettextwithformatting). These methods will extract text with formatting. Formatting means that all relative text positions will be kept after extraction and text will look more readable. Extracting text with formatting may be especially useful for PDF documents with tabular data.
+The alternative methods are [PdfDocument.GetTextWithFormatting](https://api.docotic.com/pdfdocument-gettextwithformatting) and [PdfPage.GetTextWithFormatting](https://api.docotic.com/pdfpage-gettextwithformatting). These methods extract text with formatting. Formatting means that all relative text positions will be kept after extraction and the text will look more readable. Extracting text with formatting may be especially useful for PDF documents with tabular data.
 
 ## See also
 * [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
-* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract) article
+* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract)
 * [Find and highlight text in a PDF document](/Samples/Text/FindAndHighlightText) sample

Samples/Text/ExtractTextByWords/README.md

@@ -1,9 +1,9 @@
 # Extract text from PDF by words
 This sample shows how to extract text by words from a PDF page in C# and VB.NET.
 
-[Docotic.Pdf library](https://bitmiracle.com/pdf-library/) allows you to read PDF text with detailed information (position, font, color) about every text chunk. Use [PdfPage.GetWords() method](https://bitmiracle.com/pdf-library/api/pdfpage-getwords) to extract information about all words with their coordinates from a PDF page.
+[Docotic.Pdf library](https://bitmiracle.com/pdf-library/) allows you to read PDF text with detailed information (position, font, color) about every text chunk. Use the [PdfPage.GetWords method](https://api.docotic.com/pdfpage-getwords) to extract information about all words with their coordinates on a PDF page.
 
 ## See also
 * [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
-* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract) article
+* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract)
 * [Find and highlight text in a PDF document](/Samples/Text/FindAndHighlightText) sample

Samples/Text/FindAndHighlightText/README.md

@@ -1,9 +1,9 @@
 # Find and highlight text in PDF document
 This sample shows how to find and highlight phrase in a PDF document in C# and VB.NET.
 
-Use [PdfPage.GetWords() method](https://bitmiracle.com/pdf-library/api/pdfpage-getwords) to extract information about all words from PDF page. Find your phrase in the collection of words. Then highlight the result using [PdfPage.AddHighlightAnnotation method](https://bitmiracle.com/pdf-library/api/pdfpage-addhighlightannotation).
+Use the [PdfPage.GetWords method](https://api.docotic.com/pdfpage-getwords) to extract information about all words on a PDF page. Find your phrase in the collection of words. Then highlight the result using the [PdfPage.AddHighlightAnnotation method](https://api.docotic.com/pdfpage-addhighlightannotation).
 
 ## See also
 * [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
-* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract) article
+* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract)
 * [OCR PDF and convert to searchable document](/Samples/Text/OcrAndMakeSearchable) sample

Samples/Text/FixGarbledText/README.md

@@ -5,11 +5,11 @@ There are searchable PDF documents that look just fine. But it’s not possible
 
 This happens when the document does not contain mappings of glyphs to Unicode characters. Or contains incorrect mappings.
 
-There is [PdfTextExtractionOptions.UnmappedCharacterHandler](https://bitmiracle.com/pdf-library/api/pdftextextractionoptions-unmappedcharactercodehandler) property. This sample shows how to perform OCR for unmapped characters and then replace them with correct Unicode values.
+There is the [PdfTextExtractionOptions.UnmappedCharacterHandler](https://api.docotic.com/pdftextextractionoptions-unmappedcharactercodehandler) property. This sample shows how to perform OCR for unmapped characters and then replace them with correct Unicode values.
 
 This sample uses [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) and [Tesseract OCR Engine](https://github.com/charlesw/tesseract). You would also need to have [Visual Studio 2015-2019 x86 & x64 runtimes](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) installed.
 
 ## See also
-* [OCR PDF in C# and VB.NET](https://bitmiracle.com/blog/ocr-pdf-in-net) article
-* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract) article
-* [Get free time-limited license key for Docotic.Pdf](https://bitmiracle.com/pdf-library/download)
+* [Get free time-limited license key for Docotic.Pdf](https://bitmiracle.com/pdf-library/download)
+* [OCR PDF in C# and VB.NET](https://bitmiracle.com/blog/ocr-pdf-in-net)
+* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract)

Samples/Text/Fonts/README.md

@@ -1,8 +1,17 @@
-# Fonts
-This sample shows how to use fonts in Docotic.Pdf library.
+# Using PDF fonts in C# and VB.NET
 
-Docotic.Pdf library provides several ways to add fonts to PDF document. You can add a font from a file using PdfDocument.AddFontFromFile(..) method. This method supports TrueType fonts, TrueType font collections and Type1 fonts.
+This sample shows how to use PDF fonts in [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
 
-You can also add any font installed on your system, a one of 14 built-in fonts or a font created from a System.Drawing.Font object using PdfDocument.AddFont(..) method. The names of 14 built-in PDF fonts are in PdfBuiltInFont enumeration. 
+The code uses Canvas API that can work with fonts in new and existing PDF documents. If you are going to create a new PDF, then consider using Layout API that can [make PDF generation easier](https://bitmiracle.com/pdf-library/layout/).
 
-You can specify a font to use on canvas using PdfCanvas.Font property. PdfCanvas.FontSize property specifies the size of a font.
+## Description
+
+The library provides several ways to add fonts to PDF documents. You can add a font from a file using one of the [PdfDocument.AddFontFromFile](https://api.docotic.com/pdfdocument-addfontfromfile) methods. This method supports TrueType fonts, TrueType font collections, and Type1 fonts.
+
+[PdfDocument.AddFont](https://api.docotic.com/pdfdocument-addfont) methods can add any font installed on your system, a one of 14 built-in fonts or a font created from a `System.Drawing.Font` object. The names of 14 built-in PDF fonts are in the [PdfBuiltInFont](https://api.docotic.com/pdfbuiltinfont) enumeration.
+
+You can specify a font to use for a canvas text by using the [PdfCanvas.Font](https://api.docotic.com/pdfcanvas-font) property. The [PdfCanvas.FontSize](https://api.docotic.com/pdfcanvas-fontsize) property specifies the size of the font.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Unicode text in PDF using C# and VB.NET](/Samples/Text/Internationalization)

Samples/Text/Internationalization/README.md

@@ -1,4 +1,15 @@
-# Internationalization
-This sample shows how to draw text in different languages.
+# Unicode text in PDF using C# and VB.NET
 
-Docotic.Pdf library can be used to draw text in any language. Note, that current canvas font should support characters in a text that is to be drawn.
+This sample shows how to draw text in different languages using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/).
+
+The code uses Canvas API that can add text to any PDF document. If you are going to create a new PDF, then consider using Layout API that can [make PDF generation easier](https://bitmiracle.com/pdf-library/layout/).
+
+## Description
+
+The library can draw text in any language, but the current canvas font must support all characters in the text.
+
+One use set up a font that [contains glyphs for all characters](https://api.docotic.com/pdffont-containsglyphsfortext) in the text, you can draw the text using [PdfCanvas.DrawString](https://api.docotic.com/pdfcanvas-drawstring) and [PdfCanvas.DrawText](https://api.docotic.com/pdfcanvas-drawtext) methods.
+
+## See also
+* [Get free time-limited license key](https://bitmiracle.com/pdf-library/download)
+* [Draw text on PDF canvas in C# and VB.NET](/Samples/Text/DrawText)

Samples/Text/OcrAndExtractText/README.md

@@ -1,16 +1,16 @@
 # OCR PDF and extract plain text in C# and VB.NET
 This sample shows how to recognize and extract text from non-searchable PDF documents using [Docotic.Pdf library](https://bitmiracle.com/pdf-library/) and [Tesseract OCR Engine](https://github.com/charlesw/tesseract).
 
-Follow these steps to do OCR when PDF page does not contain searchable text:
+Follow these steps to do OCR when a PDF page does not contain searchable text:
 1. Save the page as high-resolution image using Docotic.Pdf. Higher resolution leads to better recognition quality.
 2. Recognize the image using Tesseract OCR engine. 
 3. Use recognized text.
 
-If your documents contain text in language(s) other than English, then make sure to provide [Language Data Files for Tesseract 4.00](https://github.com/tesseract-ocr/tessdata/tree/4.0.0) for the language(s) of your document.
+If your documents contain text in language(s) other than English, provide [Language Data Files for Tesseract 4.00](https://github.com/tesseract-ocr/tessdata/tree/4.0.0) for the language(s) of your document.
 
 Also ensure that you have [Visual Studio 2015-2019 x86 & x64 runtimes](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) installed.
 
 ## See also
-* [OCR PDF in C# and VB.NET](https://bitmiracle.com/blog/ocr-pdf-in-net) article
-* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract) article
-* [Get free time-limited license key for Docotic.Pdf](https://bitmiracle.com/pdf-library/download)
+* [Get free time-limited license key for Docotic.Pdf](https://bitmiracle.com/pdf-library/download)
+* [OCR PDF in C# and VB.NET](https://bitmiracle.com/blog/ocr-pdf-in-net)
+* [Extract text from PDF in C# and VB.NET](https://bitmiracle.com/pdf-library/pdf-text/extract)