Fixed markdown linter findings

Author: soumeh01

CONTRIBUTING.md

@@ -1,4 +1,5 @@
 # Contributing to vidx2pidx
+
 We want to make contributing to this project as easy and transparent as possible, whether it's:
 
 - Reporting a bug
@@ -7,10 +8,13 @@ We want to make contributing to this project as easy and transparent as possible
 - Proposing new features
 
 ## We develop with Github
+
 We use Github to host code, track issues and feature requests, as well as accept pull requests.
 
 ## We use [Github flow](https://guides.github.com/introduction/flow/index.html), so all code changes happen through Pull Requests
-Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests:
+
+Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)).
+We actively welcome your pull requests:
 
 1. Fork the repo and create your branch from `main`.
 2. If you've added code that should be tested, add [tests](https://golang.org/pkg/testing/).
@@ -20,9 +24,11 @@ Pull requests are the best way to propose changes to the codebase (we use [Githu
 6. Open a [pull request](https://github.com/Open-CMSIS-Pack/vidx2pidx/pulls)!
 
 ## Report bugs using Github's [issues](https://github.com/Open-CMSIS-Pack/vidx2pidx/issues)
+
 We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/Open-CMSIS-Pack/vidx2pidx/issues/new).
 
 ## Write bug reports with detail, background, and sample code
+
 **Great Bug Reports** tend to have:
 
 - A quick summary and/or background
@@ -34,4 +40,6 @@ We use GitHub issues to track public bugs. Report a bug by [opening a new issue]
 - Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
 
 ## Any contributions you make will be under the Apache 2.0 Software License
-In short, when you submit code changes, your submissions are understood to be under the same [Apache 2.0 License](https://choosealicense.com/licenses/apache-2.0/) that covers the project. Feel free to contact the maintainers if that's a concern.
+
+In short, when you submit code changes, your submissions are understood to be under the same [Apache 2.0 License](https://choosealicense.com/licenses/apache-2.0/)
+that covers the project. Feel free to contact the maintainers if that's a concern.

DEVELOPING.md

@@ -1,32 +1,55 @@
-# Developing vidx2pidx
+# Developing `vidx2pidx`
 
-Follow steps below to start developing for `vidx2pidx`:
-1. Requirements:
-	- [Install Make](https://www.gnu.org/software/make/)
-	- [Install Golang](https://golang.org/doc/install) 
-	- [Install GolangCI-Lint](https://golangci-lint.run/usage/install/#local-installation)
+Follow these steps to set up and start developing for `vidx2pidx`:
 
-2. Clone the repo:
-`$ git clone https://github.com/open-cmsis-pack/vidx2pidx.git`
+## Prerequisites
 
-3. Enter the checked source
-`cd vidx2pidx`
+Ensure you have the following installed:
 
-4. Configure your local environment
-`make config`
+- [GNU Make](https://www.gnu.org/software/make/)
+- [Golang](https://golang.org/doc/install)
+- [GolangCI-Lint](https://golangci-lint.run/usage/install/#local-installation)
 
-5. Make sure all tests are passing
-`make test-all`
+## Setup
 
-6. Make sure it builds
-`make build/vidx2pidx`
+1. Clone the repository:
 
-7. Done! You can now start changing the source code, please refer to [contributing guide](CONTRIBUTING.md) to start contributing to the project
+   ```sh
+   git clone https://github.com/open-cmsis-pack/vidx2pidx.git
+   ```
 
-# Releasing
+2. Navigate into the project directory:
 
-If you have rights to push to the `main` branch of this repo, you might be entitled to
-make releases. Do that by running:
-`make release`
+   ```sh
+   cd vidx2pidx
+   ```
 
-*NOTE*: We use [Semantic Versioning](https://semver.org/) for versioning vidx2pidx.
+3. Configure your local environment:
+
+   ```sh
+   make config
+   ```
+
+4. Run tests to verify everything is working:
+
+   ```sh
+   make test-all
+   ```
+
+5. Build the project:
+
+   ```sh
+   make build/vidx2pidx
+   ```
+
+6. You're all set! 🎉 Start modifying the source code and refer to the [Contributing Guide](CONTRIBUTING.md) for guidelines on contributing.
+
+## Releasing
+
+If you have push access to the `main` branch, you can create a new release by running:
+
+```sh
+make release
+```
+
+📌 **Note:** We follow [Semantic Versioning](https://semver.org/) for versioning `vidx2pidx`.  

README.md

@@ -15,10 +15,11 @@ and generate a `pidx`-formatted output listing packages.
 
 Just head to the release page and download the binary for your system.
 
-
 ## Usage
+
 - update your `vendor.pidx` file as [documented](https://open-cmsis-pack.github.io/Open-CMSIS-Pack-Spec/main/html/packIndexFile.html#pidxFile)
-  ```
+
+  ```xml
   <?xml version="1.0" encoding="UTF-8" ?>
   <index schemaVersion="1.0.0" xs:noNamespaceSchemaLocation="PackIndex.xsd" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
     <vendor>MyVendor</vendor>
@@ -30,8 +31,10 @@ Just head to the release page and download the binary for your system.
     </pindex>
   </index>
   ```
-- create a vendor index file as [documented]( )
-  ```
+
+- create a vendor index file as documented
+
+  ```xml
   <?xml version="1.0" encoding="UTF-8" ?>
   <index schemaVersion="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema-instance" xs:noNamespaceSchemaLocation="PackIndex.xsd">
     <vendor>MyVendor</vendor>
@@ -43,7 +46,9 @@ Just head to the release page and download the binary for your system.
     </vindex>
   </index>
   ```
+
 - invoke `vidx2pidx vendor.vidx` 
+
   ```bash
   $ vidx2pidx <index>.vidx
 
@@ -58,6 +63,7 @@ Just head to the release page and download the binary for your system.
   ```
 
 Now the generated `index.pidx` can be used with cpackget to validate that all listed packs can be installed:
-- invoke `cpackget init ./index.pidx -R ./pack_root_test` to use the generated index.pidx in pack_root_test/.Web/index.pidx
-- invoke `cpackget --public -R /pack_root_test` to list all latest public pack versions
 
+- invoke `cpackget init ./index.pidx -R ./pack_root_test` to use the generated index.pidx in
+ pack_root_test/.Web/index.pidx
+- invoke `cpackget --public -R /pack_root_test` to list all latest public pack versions