[Documentation]

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# Contribution Guidelines
+
+This library is the culmination of the expertise of many members of the open source community who have dedicated their time and hard work. The best way to ask for help or propose a new idea is to [create a new issue](https://github.com/arduino-libraries/LiquidCrystal/issues/new) while creating a Pull Request with your code changes allows you to share your own innovations with the rest of the community.
+
+The following are some guidelines to observe when creating issues or PRs:
+
+- Be friendly; it is important that we can all enjoy a safe space as we are all working on the same project and it is okay for people to have different ideas
+
+- [Use code blocks](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet#code); it helps us help you when we can read your code! On that note also refrain from pasting more than 30 lines of code in a post, instead [create a gist](https://gist.github.com/) if you need to share large snippets
+
+- Use reasonable titles; refrain from using overly long or capitalized titles as they are usually annoying and do little to encourage others to help :smile:
+
+<<<<<<< HEAD
+- Be detailed; refrain from mentioning code problems without sharing your source code and always give information regarding your board and version of the library.
+=======
+- Be detailed; refrain from mentioning code problems without sharing your source code and always give information regarding your board and version of the library
+>>>>>>> a6f956e06b58a37b58160fb9bb3c1ee06341f6a5

README.adoc

@@ -1,11 +1,74 @@
-= Liquid Crystal Library for Arduino =
+Liquid Crystal Library for Arduino
+----------------------------------
 
-This library allows an Arduino board to control LiquidCrystal displays (LCDs) based on the Hitachi HD44780 (or a compatible) chipset, which is found on most text-based LCDs.
+Description
+~~~~~~~~~~~
 
-For more information about this library please visit us at
-http://www.arduino.cc/en/Reference/LiquidCrystal
+This library allows an Arduino board to control LiquidCrystal displays (LCDs) based on the Hitachi HD44780 (or a compatible) chipset, which is found on most text-based LCDs. The library works within either 4- or 8-bit mode (i.e. using 4 or 8 data lines in addition to the rs, enable, and, optionally, the rw control lines).
 
-== License ==
+Installation
+~~~~~~~~~~~~
+image:https://user-images.githubusercontent.com/36513474/69337317-5fc13200-0c82-11ea-802d-d1bd9cc0a1b1.png[alt="Liquid Crystal Icon"]
+
+First Method
+^^^^^^^^^^^^
+
+1. In the Arduino IDE, navigate to Sketch > Include Library > Manage Libraries
+1. Then the Library Manager will open and you will find a list of libraries that are already installed or ready for installation.
+1. Then search for LiquidCrystal using the search bar.
+1. Click on the text area and then select the specific version and install it.
+
+Second Method
+^^^^^^^^^^^^^
+
+1. Navigate to the https://github.com/arduino-libraries/LiquidCrystal/releases[Releases page^].
+1. Download the latest release.
+1. Extract the zip file
+1. In the Arduino IDE, navigate to Sketch > Include Library > Add .ZIP Library
+
+Features
+~~~~~~~~
+
+* **Compatible chipset**
++
+image:https://user-images.githubusercontent.com/36513474/67893895-4e03d780-fb79-11e9-814b-d8fa03689344.png[alt="chipset"]
+
+    Using Liquid Crystal library, Arduino board can control liquid displays based on the Hitachi HD44780 chipset. These chipset LCDs are easily available, come in different shapes and sizes.
+
+* **No technical details required**
+
+    A key benefit of using this liquid crystal library is that there is no need to care that much about the technical details or timings when using the display. The library happily does all of this.
+
+* **Extendable**
+
+    The library is extendable, therefore it can grow to support new LCD control devices such as I2C, SPI, Serial, 1wire, RF, CAM, etc.
+
+* **Give back**
+
+    Liquid Crystal is free for everyone. The licensed library can be copied, redistributed and used in the projects, assignments or anywhere.
+
+Example
+~~~~~~~
+
+There are many examples implemented where this library is used. You can find examples https://github.com/arduino-libraries/LiquidCrystal/tree/master/examples[here^] and on https://www.arduino.cc/en/Reference/LiquidCrystal[Arduino-Reference^].
+
+You can find liquid crystal tutorials https://www.arduino.cc/en/Tutorial/HelloWorld?from=Tutorial.LiquidCrystal[here^].
+
+Contributing
+~~~~~~~~~~~~
+
+If you want to contribute to this project:
+
+- Report bugs and errors
+- Ask for enhancements
+- Create issues and pull requests
+- Tell others about this library
+- Contribute new protocols
+
+Please read https://github.com/arduino-libraries/LiquidCrystal/blob/master/CONTRIBUTING.md[CONTRIBUTING.md^] for details on our code of conduct, and the process for submitting pull requests to us.
+
+License
+~~~~~~~
 
 Copyright (C) 2006-2008 Hans-Christoph Steiner. All rights reserved.
 Copyright (c) 2010 Arduino LLC. All right reserved.