chore: proper readme for introduction

Author: orzklv

.github/assets/footer.png

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2025 Rust Uzbekistan
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

.github/assets/header.png

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rust Uzbekistan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

LICENSE renamed to LICENSE-APACHE

@@ -1,2 +1,67 @@
-# maydon
-📝 | Field enum generation for a struct
+<p align="center">
+    <img src=".github/assets/header.png" alt="Rust Uzbekistan's {Maydon}">
+</p>
+
+<p align="center">
+    <h3 align="center">Field enum generation for struct.</h3>
+</p>
+
+<p align="center">
+    <img align="center" src="https://img.shields.io/github/languages/top/rust-lang-uz/maydon?style=flat&logo=nixos&logoColor=5277C3&labelColor=ffffff&color=ffffff" alt="Top Used Language">
+    <a href="https://t.me/rustlanguz"><img align="center" src="https://img.shields.io/badge/Chat-grey?style=flat&logo=telegram&logoColor=ffffff&labelColor=242424&color=242424" alt="Telegram Chat"></a>
+    <a href="https://github.com/rust-lang-uz/maydon/actions/workflows/test.yml"><img align="center" src="https://img.shields.io/github/actions/workflow/status/rust-lang-uz/maydon/test.yml?style=flat&logo=github&logoColor=ffffff&labelColor=242424&color=242424" alt="Test CI"></a>
+</p>
+
+## Motivation
+
+Upon writing some rusty code for CLI config management, I simply declared a struct like this:
+
+```rust
+#[derive(Debug, Serialize, Deserialize)]
+pub struct Config {
+    pub url: String,
+    pub port: u16,
+    pub database_url: String,
+    pub threads: u16,
+}
+```
+
+Also, in order to have set function with proper typed selection, I declared another enum named `Field`:
+
+```rust
+pub enum Field {
+    Url,
+    Port,
+    Database,
+    Unknown,
+    Threads,
+}
+```
+
+The thing is, I wanted to automate creation of enum generation. Ordinary macros wouldn't be a good viable solution, so I wrote maydon from ground up. I might be missing something or prequisites, but this is what I came up with:
+
+```rust
+use maydon::Maydon;
+
+#[derive(Maydon)]
+#[field_name = "Selector"]
+pub struct Config {
+    pub url: String,
+    pub port: u16,
+}
+
+// The macro should generate:
+fn main() {
+    let _ = Selector::Url;
+    let _ = Selector::Port;
+    let _ = Selector::Unknown;
+}
+```
+
+## License
+
+This project is licensed under the MIT or Apache-2.0 license - see the [LICENSE-MIT](LICENSE-MIT) or [LICENSE-APACHE](LICENSE-APACHE) file for details.
+
+<p align="center">
+    <img src=".github/assets/footer.png" alt="Rust Uzbekistan's {Maydon}">
+</p>