Better Readme

plugin/readme.txt

@@ -8,7 +8,38 @@ License URI: https://github.com/luehrsenheinrich/wpm-citations/blob/main/LICENSE
 Stable tag: 0.0.35
 Tested up to: 6.3
 
-Introduces advanced citation capabilities to the WordPress Block Editor.
+This Plugin introduces practical citation functionality to the WordPress Block Editor, aiming to streamline the process of adding references to your content.
+
+## Features
+
+1.  **Cite Rich Text Format**: This feature lets users mark citations in their text and assign them a specific source. This makes adding citations straightforward, enhancing the clarity and reliability of your content.
+2.  **Bibliography Block**: This plugin also offers a bibliography block that displays all referenced sources. The plugin creates links between your in-text citations and their corresponding sources in the bibliography block, making it easier for readers to find and check your references.
+
+### Creating In-Text Citations
+1. Navigate to the Posts section of your WordPress dashboard.
+1. Click on the Add New button to create a new post, or select an existing post where you want to add citations.
+1. Type your content into the WordPress Block Editor.
+1. To add a citation, first highlight the text that you want to cite.
+1. With the text still highlighted, find and click on the "Cite" format from the rich text format toolbar.
+1. A pop-up will appear asking you to define your source. Input the source information into the fields provided.
+
+### Adding a Bibliography Block
+1. Click on the + icon in the editor toolbar to add a new block to your post.
+1. Search for "Bibliography" in the block search bar.
+1. Click on the Bibliography block to add it to your post.
+1. The Bibliography block will automatically populate with the sources of all the in-text citations you've added to your post. Each citation in the text is linked to its corresponding source in the bibliography, allowing readers to easily check your references.
+
+### Editing Citations and Sources
+1. To edit a citation or source, click on the citation in the text.
+1. Make the necessary changes in the pop-up that appears.
+1. Click on Save or Update to apply your changes.
+
+### Using the Demo-Pattern
+
+1. Click on the + icon in the editor toolbar to add a new pattern to your post.
+2. Search for "Citations Demo" in the pattern search bar.
+3. Click on the "Citations Demo" pattern to add it to your post.
+4. A few lines of filler text with pre-defined citations and a bibliography block will appear in your post content.
 
 == Installation ==
 = From within WordPress =